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ComputerLand 

■ Tysons Corner 

dapple computer 

Authorized Dealer 


8411 Old Courthouse Road 
(at Route 1 23) 
Vienna, Virginia 22180 

Sales (703) 893-0424 
Service (703) 893-0114 





There’s only one place to buy apples. 


AT FREDERICK COMPUTER PRODUCTS ! ! i 

As an Authorized Apple Dealer we offer a full selection of 
both Apple Hardware and Software at low , low prices . 

Also, as an Authorized Service Center we provide fast and 
efficient service on all Apple products. 



Frederick Computer Products, Inc. 

Microcomputer Systems And Peripherals 
5726 INDUSTRY LANE-FREDERICK , MD . - (301)694-8884 
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TRI-STATE SYSTEMS 

DISCOUNT APPLE SOFTWARE 



HOLIDAY SPECIALS 





Our 



Our 


Retail 

Price 


Retail 

Price 

Choplifter 

34.95 

24.50 

LE MONITOR (SPECIFY GREEN OR B&W) 


TG Joysticks 

59.95 

46.95 

9" Green or B&W Non-glare w/any 



Choplifter & TG Joysticks . . . 

94.90 

66.95 

additional purchase of $50 or more . 

. .139.95 

99.95 

Quadrant 6112 

34.95 

24.50 

Computer Quarterback 

. . .39.95 

29.95 

Star Blazer 

31.95 

22.95 

Frogger 

. . .34.95 

24.50 

Swashbuckler 

34.95 

24.50 

MEMOREX (10 disks) 5 Va " 



Cannonball Blitz 

34.95 

24.50 

w/free disk coupon 

. . .42.00 

26.95 




Our 



Our 

SPECIALS 

Retail 

Price 

GAMES 

Retail 

Price 

Wizardry 

49.95 

37.95 

Gorgon 

.39.95 

31.50 

Wizardry II 

34.95 

25.95 

Threshold 

.39.95 

29.95 

Wizardry 1 & II 

84.90 

59.95 

Crossfire 

.29.95 

22.50 

Ultima II 

59.95 

42.95 

Oo-Topos 

.32.95 

25.50 

Castle Wolfenstein 

29.95 

19.95 

Cyborg 

.32.95 

25.50 

Snack Attack 

29.95 

19.95 

Kabul Spy 

.34.95 

27.50 

Time Zone 

99.95 

69.95 

Tigers in the Snow 

.39.95 

31.50 

Apple Panic 

29.95 

19.95 

The Road to Gettysburg 

.59.95 

47.50 

Rear Guard 

29.95 

19.95 




Gold Rush 

34.95 

25.95 

UTILITIES 



Track Attack 

29.95 

20.95 

Screen Writer II 

129.95 

99.50 

Cytron Masters 

39.95 

29.50 

The Graphics Magician 

.59.95 

47.50 

Guadalcanal Campaign 

59.95 

41.95 

The Artist 

.79.95 

63.50 

Marauder 

34.95 

24.95 

LISA 2.5 

.79.95 

63.50 

Trick Shot 

39.95 

29.50 

LISA Educational Pkg 

119.95 

89.50 

David’s Midnight Magic 

34.95 

24.95 




Zork 1 

39.95 

29.50 

HARDWARE 



Zork II 

39.95 

29.50 

Adam & Eve Paddles 

.39.95 

31.50 

Zork 1 & II 

79.90 

55.50 

Sirius Joyport 

.49.95 

39.95 

Deadline 

49.95 

37.95 

Videx Videoterm 80 



Falcons 

29.95 

20.95 

w/softswitch & inverse video 

385.00 

315.00 

Bandits 

34.95 

24.95 

LE MONITOR (SPECIFY GREEN OR B&W) 


Lemmings 

29.95 

21.50 

9" Green or B&W Non-glare 

139.95 

119.95 

Laf Pak 

34.95 

25.95 

12" Green or B&W Non-glare 

159.95 

129.95 

Mouskattack 

39.95 

29.50 

Penguin Software: The Space Tablet 



Jawbreaker 

29.95 

21.50 

w/complete Graphics System Software . 

395.00 

325.00 

ALL ORDERS SUBJECT TO AVAILABILITY OF MERCHANDISE 





VISA 

• We accept VISA or Mastercard (include card # and 
expiration date), personal checks (allow 2 weeks), 

Mail orders to: 

or money orders. No credit card penalty! 

TRI-S TA TE S YS TEMS 


• VA residents add 4% sales tax 

P.O. Box 2314 


• Include $2.00 for shipping 

Alexandria, VA 22301-0314 


• All software products on disk 

(MasterCard J 

• All prices subject to change without notice 

• We carry a large line of discount software/hardware. 

or call: (703) 569-9363 

i ^ ^ ^ ^ « 

Write us for our free catalog. 

L HAVE A HAPPY HOLIDA Y SEASON! 


T J 
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This is the 46th issue of an unbroken 
series of issues of the Pi. It is a 
record of which we can all be proud. I 
firmly believe that a manor contribut- 
ing factor to the strength, health and 
growth of any computer users 1 group is 
the way in which its members communi- 
cate with each other - the newsletter. 
It constantly amazes me to witness the 
flow of new materials which arrives 
just in time for the next issue. 

I should like to draw your attention to 
one of our most prolific contributors - 
David Morganstein. Here is a person 
who holds down a full-time job. runs 
the Washington Apple Pi, gives tutori- 
als and writes articles - all this 
while helping out at home with two 
young children. You will notice at 
least four articles by him (or co- 
authored) in this issue, despite the 
fact that on top of everything I've 
mentioned, this month was moving time 
for him both at the office and at home. 
This is certainly not intended to deni- 
grate the contributions made by our 
other regulars to these pages, of which 
there are many, but I personally feel 
that member accolades are in order for 
our President. How about you? 


Please note that the article on FIG- 
Forth by Bill Wurzel is a welcome first 
of a series which will appear in the 
next several issues of the Pi. ^ 


£. V€_ H T Q U €_ U €. 

Washington Apple Pi meets on the 4th 
Saturday (usually) of each month at the 
Uniformed Services University of the 
Health Sciences (USUHS), Building B, 
4301 Jones Bridge Road, Bethesda, MD. 
on the campus of the National Naval 
Medical Center. Sales, library trans- 
actions, newsletter pickup, etc. are 
from 8:30 - 10:00 AM. From 9:00 to 

10:00 AM there will be an informal 
"Help" session in the auditorium. The 
main meeting starts promptly at 10:00, 
at which time all sales and services 
close so that volunteers can attend the 
meeting. 

Because of the Holidays, the December 
meeting will be on the THIRD Saturday. 

Following are the speakers and topics 
for the next few months: 


December 18 - Swap Meet 

(3rd. Sat.) 


January 22 


Pascal - Dr. Wo 


February 19 
(3rd Sat.) 


Hardware Interfacing 
Tom Riley 

<* 
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minutes 


OCTOBER GENERAL MEETING 

The monthly general meeting of WAP was held 
on October 30, 1982 at USUHS. The WAP 

hotline volunteers are available to answer 
questions for purchased software only. The 
Apple Tech Notes will be gradually pub- 
lished in the Pi but if anyone wants their 
own copy, $7.50 discount coupons are avail- 
able. This month* s demonstration was by 
the Montgomery County Teachers ; next 
month’s is on Graphics. Any suggestions or 
volunteers for demonstrations are welcome. 
The upcoming tutorial is on Pascal. In 
January Beginning Tutorials will be 
offered. A1 Weiner is coordinating a com- 
puter fair and needs some volunteers. The 
December WAP meeting will be a swap fest. 
There will be no commercial sales. Volun- 
teers are needed. The day will end with an 
auction to dispose of goods still remain- 
ing. Betsy Harriman needs contributors and 
help in collating a new member handbook. 
Volunteers were sought to handle the WAP 
booth at the Mid-Atlantic Computer Show. 
Appleseeds is looking for some adult volun- 
teers to help them. The SIG/Disabled is 
examining Special Education as a new focus. 
For the club store, there will be a special 
line for buying diskettes, and picking up 
prepaid orders. Volunteers will be needed 
to help form these lines and write re- 
ceipts. The Group Purchase Chairman will 
look into purchasing Source memberships at 
roup rates. Volunteers were solicited to 
ost informal gatherings by localities. A 
poll was taken as to wno had heard of and 
were satisfied or not with Apple Orchard, 
the bimonthly publication of IAC. The June 
ACM conference here in Washington has put 
in a call for papers on applications, 
hardware, or software on microcomputers. A 
motion was made and passed that the Bylaws, 
published in the October issue of Pi be 
adopted and assets be transferred to the 
new corporation WAP, Ltd. 

The presentation was on PILOT by Robert 
Platt. 

SUMMARY - NOVEMBER BOARD MEETING 

The Executive Board of WAP, Ltd. met on 
November 10, 1982 at the home of the 

Urbans, with 18 people present. Following 
a report on the office search, the Presi- 
dent was authorized to execute a lease. A 
report on library acquistions included a 
call for pledges of office furniture/equip- 
ment. Bernie Urban was nominated as IAC 
Eastern Region Director. If an AJ8032 
printer is available, the Board approved an 
exchange of an ad in the Pi for a short 
term loan of a printer with maintenance. A 
new member manual and disk is being pre- 
pared. Methods to handle the long lines at 
the club store were discussed. Our 
presence at the Mid-Atlantic Computer Show 
was reported on. Enough volunteers were 
received to plan Apple Teas for December 
and January. Out of a discussion on the 
needs of Appleseeds came a Bylaw amendment 
that no SIG shall collect dues or contri- 
butions without Board approval. Guidance 
was given to the scope of a vendor fair. 


Approval was given to have ALF make disk 
labels. A one page description of the call 
for papers by ACM will be included in the ' ' 

December newsletter. A report on the 
demonstration programs at the monthly 
meetings was given. An update of the mem- 
bership directory was proposed. The ABBS 
Sysop was authorized to acquire Applesoft 
ROM chips. & 


GENERAL INFORMATION 

Apple user groups may reprint without prior 
permission any portion of the contents 
herein, provided proper author, title and 
publication credits are given. 

Membership dues for Washington Apple Pi are 
$18.00 per year, beginning in the month 
joined. If you would like to join, please 
call the club phone and leave your name and 
address, or write to the P.0. Box above. A 
membership application will be mailed to 
you. 

Subscriptions to the Washington Apple Pi 
Newsletter are not available. The 
newsletter is distributed as a benefit of 
membership. <& 




G IFT3 FOR 

g r me 3 t e r 3 

by Jim Motherly 

With the holiday season approaching, I 
thought it would be a good idea to give 
some suggestions for gifts for the game- 
sters on your list. Within this limited 
space, I will only make a few sugges- 
tions, and I hope one of them is right for 
you. 

The first gift that I would recommend for 
the serious gamester is a joystick. There 
are several types to choose from. You 
should try them out at your local computer 
store to see which is right for you. 

The other suggestion that I have is a com- 
puter game, and there are several types to 
choose from. If the person you are giving 
the gift to enjoys arcade type games, then 
I would recommend THRESHOLD for the more 
experienced player and SNEAKERS as a game 
the whole family can play and enjoy. If 
the person enjoys adventure games, I recom- 
mend WIZARDRY, especially for those who are 
into Dungeons and Dragons; and ULTIMA for 
those who want something less complex. 
These suggestions are far From complete but 
should provide a place to start from. ® 
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Have a problem? The following club mem- 
bers have agreed to help. PLEASE, respect 
all telephone restrictions, where listed, 
and no calls after 10:00 PM. 

General 

Robert Fretwell 
Dave Harvey 

Robert Martin 

971-2621 

527-2704 

498-6074 

APPLE SSC 

Bernie Benson 

546-0076 

Apple TechNotes 

Ed Schenker 

977-7349 

Communications 
Data Capture 
VISITERM 

Packages 

Howard Simkowitz 
Steve Wildstrom 

882-4645 

933-7728 

Expediter Cmplr 

.Peter Rosden 

229-2288 


f* a Roopa 

DB Master Dave Einhorn 593-8420 

Leon Raesly 460-0754 

Data Perfect Leon Raesly 460-0754 

Games Jim Eatherly 232-6046 

Donn Hoffmann 9o6-26l6 


Graphics 


Bill Schultheis 538-4575 


Home Account Leon Raesly 


460-0754 


Languages (A=Applesoft , I=Integer, 
P=Pascal, M=MachineT 


A 

a’ 1 

A, I , P ,M 

A,I,M 

P 


Peter Combes 871-1455 
Jeff Dillon 422-6458 
Mark Pankin 370-9219 
Bill Schultheis 538-4575 
Richard Untied 241-8678 
Robert Fretwell 971-2621 


Locksmith 


Leon Raesly 


460-0754 


Modems-Telecom. Ben Acton 428-3605 

Tom Nebiker (216) 867-7463 
ASCII Express Dave Harvey 527-2704 

Hayes Smartmod.Bernie Benson 546-0076 

XTALK CP/M Cora.Bernie Benson 546-0076 


Operating Systems 

APPLE DOS Richard Untied 241-8678 

CP/M Robert Fretwell 971-2621 


Paddles 

Tom Riley (eve. ) 

340-9432 

Pers. Fil. Sys. 

Ben Ryan 

469-6457 

Printers 

General 
Anderson Jac. 

IDS 460 

MX-80 

Silentype 

Walt Francis 

Bill Etue 

Leon Raesly 

Jeff Stetekluh 

Jeff Dillon 

Bruce Field 

966-5742 

620-2103 

460-0754 

521-4882 

422-6458 

340-7038 

Time-Sharing 

Chuck Reinbrecht 
Dave Harvey 

299-6810 

527-2704 

VisiCalc 

Walt Francis 

Leon Raesly 

966-5742 

460-0754 

Word Processors 
Apple Writer 
Letter Perfect 
Screen Wrtr.II 
Supertext II 

WordStar 

Walt Francis 

Bruce Field 

Leon Raesly 

Peter Combes 

Peter Rosden 

Leon Raesly 

David Inouye 

966-5742 

340-7038 

460-0754 

871-1455 

229-2288 

460-0754 

422-8926 


$$$ DISCOUNT PRICES $$$ 

2% Discount 
for Certified Checks 


D.C. Hayes Micromodem il S 280 

D.C. Hayes Smartniodem S 230 

Universal Data Systems 202 LP S 200 

Universal Data Systems 212 LP S 380 

NEC 8023 Printer S 475 

PRISM 80 (Graphics, Sheet Feed. Sprint Mode) .... S 1,100 

PRISM 80 (above plus Color) SI .400 

PRISM 132 (Graphics, Sheet Feed. Sprint. Color) ... S 1.550 

Okidata Micro 82 A S 440 

Okidata Micro 83 A S 680 

NEC 7710 Spinwriter (RS 232) S 2.350 

Grappler (Cable included - Specify Printer) S 140 

Micro Buffer II (32 K) - Specify Printer) S 240 

AMDEK RGB Color Monitor S 750 

AMDEK DVMBOARD S 145 

NEC Monitor 12” Green $ 165 

AMDEK 13 Color Monitor S 330 

Axlon Ramdisk 320 K S 1,050 

Microtek 16K Memory Board S 85 

Softcard Premium System (Z 80. 16 K & Videx) S 525 

Mu-Math S 200 

D BASE-AP S 450 

Wordstar-AP S 200 

UK Letter Perfect S 105 

Visicalc 3.3 S 185 

Visiterm S 85 

Visiplot S 150 

Visidex S 1 85 

Visitrend / Plot S215 

Visifile S 1 85 

Desk top Plan II for Apple on Disk S 185 

Visipak (Includes Visicalc. Visifile & Visitrend/PIot) . . . S 490 

Visischedule S215 

.Also available: 


Altos. Anadex. Atari. Konan. Micropro. 

Mountain Computer, North Star. Sanyo. Televideo 
and Ventel Products 

Call for Quotes for Items not Listed 

— VISA/MC. money order, certified checks 
— Prices subject to change without notice 

- All items subject to availability 

- No extra charge for VISA/MC 

- Shipping & Handling 2% (S5 minimum) 

— MD residents add 5 % tax 

RAMADA COMPUTER PRODUCTS 

A Division of H A H Scientific 
1 3507 Pendleton Street 
Fort Washington. Maryland 20744 
Telephone: (301 ) 292-3100 
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PR£5 I D£flT ’ 5 CORf|£R 

by David fTlorganstein 


Apple Teas 

At the October meeting we discussed start- 
ing a series of small meetings around the 
area. These meetings would provide a 
"quieter" opportunity for learning about 
the Apple, sharing knowledge and sharing 
some hands-on experience with others. 
About 20 members volunteered the use of 
their home for this purpose. Elsewhere in 
the magazine you will find a list of their 
names, locations and phone numbers as well 
as one or two dates for the first of these 
"Apple Teas". Please call these folks to 
RSvP your interest in visiting. From the 
long list you should be able to find some- 
one near you who will be holding a session 
at a time convenient for you. They will 
limit attendance to the available space at 
their home. The club expresses its thanks 
for their willingness to help in this way. 
We will see how many people attend and the 
service these sessions provide. If they 
prove valuable, we will call for other 
volunteers and expand the list. 


Office 




It's official!!! We have a one-year lease 
on about 750 sg. ft. in northern Bethesda 
(8227 Woodmont Ave. near Battery Lane). We 
will open after modifications are complete, 
perhaps in December. If so, we will hold 
an open house to bring in the Holiday 
spirit. (Apple cider will be served...) 

If you have any office furniture to lend 
us, give me a call. We need two desks, 
many chairs, a filing cabinet and two 
tables (one for meeting around, another for 
magazine layout). We purchased several 
book cases during the Brentano's close-out 
sale so our Library will be able to shape 
up quickly. (See Library below.) 


Hot Line 

A number of Hot Line volunteers have 
received requests for information about 
software from people who appear not to be 

?urchasers of the programs in question. 

hat is, the callers are not aware of the 
basic information provided in the owner's 
manual. The Hot Line should only be used 
by purchasers of the product to obtain 
program-specific information. Many of the 
Hot Line subjects are not connected to 
specific products; these topics can be used 
by all members. Please respect a Hot Line 
volunteer's request for registration num- 
bers if they want to verify that the caller 
is indeed an owner of the product. 


• • • • • 

Swap Fest 

Make sure that you note the December meet- 
ing on your calendar (the THIRD Saturday). 
We will hold a swap fest in the cafeteria 


in lieu of having a speaker after the 10 AM 
meeting. Swapping should begin around 
10:45. This is an opportunity to exchange 
unwanted items such as games you have not 
been able to solve and are too exhausted to 
continue trying. . .Please remember this is 
for personal property, no commercial sales. 

• • • • • 

Library 

We have obtained shelving for the Library 
and are ready for donations of magazines 
and books. You can make these permanent 
loans for now and can donate them if and 

when we obtain the IRS status which makes 

donations tax deductible. Contact Jess 
Wagstaff with offers to loan magazines and 
books to the WAP Library. 

• • • • • 

Speakers & Demonstrations 

Our first demonstration session, held in 
the Cafeteria at the October meeting, went 
well. Thanks to Chuck Philipp ana the 
teachers who brought in and demonstrated 
their interesting science experiments. It 
is always amazing to see what can be done 
with the Apple!! If you have equipment or 
software you would like to demonstrate or 
see demonstrated, contact the coordinators, 
Harry Misuriello or Julie Oliver (their 
phone numbers are on the masthead). 

Are you interested in being a speaker at 
our monthly meeting? If so, contact Ernie 
Forman, Tom Woteki or me to express your 
interest. We need topics and speakers for 
the March 83 and beyond meetings. 

• • • • • 

USUHS 

Due to a reassignment, Col. Dick Hodder is 
not regularly located at USUHS. We have 
another USUHS staff member who is acting as 
host and helping to coordinate our uses of 
the facilities. Chet Pletzke, Director of 
the Learning Resource Center, has taken on 
that burden. I would like to express the 
appreciation to Dick for the many hours he 
has spent on our behalf in arranging for 
our presence at an excellent facility. I 
look forward to working with Chet in the 
future. 

If members have space or equipment needs or 
problems, however, they should work ONLY 
through Jim Carpenter, Arrangements Chair- 
man. Jim is constantly in touch with Chet 
and the USUHS staff and knows how to 
resolve any needs you may have. Jim's 
phone number is found in the masthead list. 

• • • • • 

Tutorials 

Our next tutorials will be on Pascal and be 
taught by Tom Woteki; the Nobember issue 

contd. 
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HARDWARE 


DISK DRIVES 


COMPUTER SYSTEMS 

DISKETTES 


Rana Elite One 

$359 

Franklin Ace 1000 Sys.$l,595 

Wabash 

$25 

MicroSci A-2 

$349 

Epson QX-10 Sys. 

$2,999 

Verbatim 

$30 

MODEMS 


PRINTERS 


PRINTERS 


H. Micromodem II 

$299 

NEC 8023 

$499 

Prowriter 

$510 

Apple Cat 

$350 

Epson MX80FT 

$535 

Par. interface 

$79 

Smart Modem 300 

$249 

Epson MX100 

$699 

Crappler 

$149 

Smark Modem 1200 

$595 

Okidata 82A 

$489 

Okidata 84P 

$1,085 

ACCESSORIES 


ACCESSORIES 


PRINTERS (Ltr. Dual.) 

Kraft Joystick 

$49 

Wildcard 

$125 

Starwriter — 40 cps 

$1,495 

Kraft Paddles 

$39 

CPM Prem Pac 

$585 

Printmaster — 55 cps $1,995 

16K RAM Card 

$79 

Picasso interface 

$150 

Smith /Cor. TP-1 

$725 

128K RAM Board 

$525 

System Saver 

$75 



T.C. Joystick 

$52 

Computer Desk 

$110 

MONITORS 


T.G. Paddles 

$43 

80 col. crd. (Videx) 

$250 

BMC Hi Res (20 Mhz) 

$125 

U.S.l. Mon. (AMB) 

$169 

CPM Card 

$250 

BMC 1 2A-C12 MhZ) 

$89 

Quentin Disk Drive 

$310 

v.c. Expand 

$95 

Color 1 13" 

$379 

Micro-Buffer II — 16K 

$225 

Multifunction Crd 

$190 

Comrex 13" Color 

$369 


SOFTWARE 


BUSINESS 


BUSINESS 


GAMES 


Word Handler 

$140 

Home Acct 

$60 

zork ll 

$45 

Wordstar (Apple) 

$195 

1st Class Mail 

$68 

Frogger 

$28 

List Handler 

$75 

Planner Calc (CPM) 

$89 

Apple Panic 

$25 

Sen. Speller 

$100 

dBase II 

$450 

Wizardry 

$41 

Visicalc 

$185 

Super Text (70 char.) 

$99 

Tawala’s 

$25 

Acct Pkg (Pascal) 

$495 

Screenwriter ll 

$98 

Temple of Apshai 

$32 


Call, or stop in to pick up a copy of our free APPLE catalog. 


DON’T OVERPAY — CALL THE DISCOUNTERS AT: 

THE MICRO CONNECTION 

320-A MAPLE AVENUE EAST — VIENNA, VA 22180 

PHONE 281-1866 
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contained a syllabus for the courses. 
There will be two courses. The first will 
be introductory and held in 1982. The 
second will be advanced and start in Jan. 
See the last page for a registration form. 
If you would like to teach a course, con- 
tact Steve Stern or Joe Silverman to 
volunteer. Courses can be as short as a 
single 2-3 hour session or as long as 
several such sessions at your option. If 
you would like to see a course on a certain 
subject, contact Steve or Joe. 

As a note, the registration forms show two 
fees. A base fee and a discounted one. 
The discount is offered to those willing to 
cart an Apple to the tutorials. The only 
Apples available are those brought by 
attendees. Those unable to bring an Apple 
pay the regular fee and must rely on "over- 
the-shoulder" viewing with those who 
brought an Apple. There may be a possi- 
bility of using some USUHS computers for 
these courses and we will investigate this 
further. 

• • • • • 

Overheard in Cupertino... 

"Franklin, my dear, I don't give a Basis". 
Is the WAP an "Apple only" organization? 
Or do we have room for the look alikes? It 
is said that imitation is the highest form 
of compliment .. .1 expect that Mr. Jobs et 
al can do without the compliment. Of 
course, the competition sells by mail... A 
footnote: the WAP never received a reply to 
it's letter to Apple, Inc. about mail order 
sales. & 


D£RL£RS ’ 
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APPLE WORKSHOPS! 


A variety of low-cost, hands-on workshops 
on the Apple computer are being offered at 
Clinton Computer's new Learning Center. 
Many workshops are for beginners. Workshop 
offerings include Introduction to Micro- 
computers, How to Operate the Apple, 
VisiCalc. Wordstar. BASIC Programming, 
Intermediate VisiCalc, and many other work- 
shops for home and business applications. 
Call Nancy Kelly, Director, Clinton Com- 
puter Learning Center, at (301) 868-0002 
for details and registration. Class size 
is limited, so register early for upcoming 
November ana December classes! 


HOLIDAY SALE! 


The Micro Connection Inc., the Personal 
Computer Store is having a Holiday Sale 
featuring red Christmas stockings stuffed 
with your favorite games, some containing a 
TG Joystick, all at 40$ off retail price. 
Call for a complete listing of the game 
stockings, and a copy of our free Apple 
hardware and software catalog. The store 
telephone number is 28 1-1866. Our store 
address is 320-A Maple Ave., Vienna, VA. 
22180. 


COMPUTER COURSES! 


Is your spouse a computer widow (er)? Give 
her Thim) a gift certificate for a class in 
GETTING COMFORTABLE WITH COMPUTERS or BASIC 
PROGRAMMING with Electronic Learning Facil- 
itators in Bethesda, MD. Gift certificates 
for parent/child workshops and classes for 
children in BASIC and LOGO are available 
also. Call 493-9696 for additional infor- 
mation and to receive the winter schedule. 
& 


5 I 0 /D 

H€LP 

b y C u r t 




Originally, the SIG/Disabled was estab- 
lished to make the WAP meetings accessible 
to all physically disabled members. By 
accessibility, we mean to make reasonable 
accomodations for those members who may or 
may not be able to independently conduct 
regular activities within the WAP func- 
tions, i.e. pre-meeting purchases of equip- 
ment and supplies, attending SIG meetings, 
and of course attending the regular WAP 
meetings. For example, a wheelchaired 
member may need a ride to the meeting 
place, a hearing-impaired member may need 
an interpreter, etc. Now, we are receiving 
requests for assistance over and beyond 
these intentions. 

Consider this. We have been approached by 
a WAP member who was called upon to pro- 
vide assistance to a lady using an APPLE 
for her husband who had a stroke. It left 


him with limited use of his arms and hands, 
and with limited speech. In another 
instance, we have received a call from a 
mother of a hearing-impaired son who feels 
an APPLE is a good way for him to develop 
his communication skills. And finally, 
we've expanded the SIG to include parents/ 
members who have learning disabled or 
mentally retarded chilren and who want to 
find the best suited educational software 
for their children's needs. Needless to 
say, snecial education is bevond our scone 
qL expertise . M us. need h£l£. 

It would be greatly appreciated if any WAP 
members with special education expertise, 
or who know of anyone with such knowledge, 
would join us in solidifying the founda- 
tions of this SIG. Please call John 
Molineaux at 341-7391, or leave a message 
for me on the ABBS at WAP428. 
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FOR SALE: Heathkit Microprocessor Course 
WITH Trainer. Learn microprocessor basics. 
Half original price, mint condition, $150. 
Call Bob, 262-1355 daytime. 


FOR SALE: Dynavit Computerized Fitness 
System, like new bicycle ergometer with 
chip memory of American Heart Association 
Cardiorespiratory table, solid state heart 
rate sensor. $1500 or best offer. Call 
Bob, 262-1355 daytime. 


FOR SALE: Silentype printer, $250 or best 
offer. I needed to upgrade to 132 col. 

P rinter - never had a problem with it. Bob 
chmidt, 736-4698. 


FOR SALE OR SWAP: (All prices are negoti- 
able.) Hayes Micromodem II (new). $Call; 
Dan Paymar UC/LC adapter (Rev. 0-6), $10; 

The Dictionary (On-Line). $50; Speed-ASM, 
$20; Speedstar Applesoft compiler, $40; 
Superkram 3.3 DBMS, $60; REQUEST/CONQUEST 
DBMS (uses Superkram 3.3, above). $150. All 
programs on original disk(s) with original 
documentation. Contact Barry Gordon, 
235-3125 (evenings), (301) 955-6431 
time) for details. 



FOR SALE: VisiCalc and Business Basic. 
Both brand new and unused. For Apple ///. 
$125 and $63 respectively. Save a bundle 
if you haven’t yet bought your system or 
don’t own these programs. Call Dave at 
(703) 385-9811. I have only one of each 
item. 


TOWSON COMPUTERS ANNOUNCES 
PERSONAL TOUCH 
IN 

PERSONAL COMPUTERS 



LATEST APPLE TECHNOLOGY 
SUPER SOFTWARE STOCK 
SPECIAL LOW PRICES 
FREE EXTENDED WARRANTY 
EXCLUSIVE APPLE DEALER 
PROFESSIONAL FAST SERVICE 

CONTACT JEFFREY P. CARTER 
(301) 593-3189 

AUTHORIZED AREA REPRESENTATIVE 


FOR SALE: Epson printer inf erf ace, $70. 

Call 972-5566 before 10:00 PM. 

FOR SALE: Complete printer setup. Cen- 

tronics 737-1 dot matrix printer, Micro- 
dome External Text formatting Interface, 
Apple Centronics printer card, cable docu- 
mentation. Near letter quality printing 
with powerful text formatting and dot 
matrix speed can be yours for $500. Call 
^Pej^e” Rusk, (work) 654-8234, (home) 933- 

F0R SALE: (1) Apple 11+ with 16K RAM 

memory, Videx 80 column card, Microsoft 
Softcard, 2 Apple disk drives, Apple III 
monitor, Apple stand for monitor, and game 
paddles - $2400. This system can be sold 
without Softcard as a Pascal system, $2200. 
(2) Apple super serial interface card and 
Transtar letter quality printer, which emu- 
lates Diablo 1610 and works with any Apple 
word processor and Wordstar. .With a cable 
and some installation tips - $1500. Total 
system in (1) and (2) - $3800, negotiable. 
Various software packages, e.g. Screen- 
Writer, PFS, at a reasonable price to pur- 
chaser of above system. Call Naohito Okude, 
(703) 671-2248. 

FOR SALE: Apple Pilot on original diskettes 
with full documentation, $70. Call Dave 
Einhorn, 593-8420. 

FOR SALE: APPLE 11+ 48K, Apple Disk Drive 
with controller card, Zenith 12” green CRT, 
DOS 3.3, Apple Writer. Purchased in 1 98 1 
for $21u0, used only 10 hours. $1275. 
Call Bill or Hoff, (days) 202 872-0660. a 



The ACCOUNTANT 


Finance Data Base System $129 
Optional VisiCalc™ Interface $20 

Be a Money Master. 

Define up to 63 codes and you’ll save money 
when you prepare your taxes by having an 
accurate record of every tax deduction. 

( 800 ) 368-2022 

Decision Support Software 
1438 Ironwood Drive. McLean, VA 22101 (703) 241-8316 

VisiCalc' is a Uademaric of VisiCorp Inc. Add S3. 00 shipping and handling VA residents add 4% 
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5 i g news 


SIGAMES is the special interest group of 
computer hobbyists interested in using 
their APPLEs for entertainment. They meet 
immediately following the monthly meeting 
of Washington Apple Pi. 


PIG, the Pascal Interest Group, meets on 
the third Thursday of each month at 7:30 PM 
at the Uniformed Services University of the 
Health Sciences, Bldg. A, Room 2054 (2nd 
floor), on the campus of the National Naval 
Medical Center at 4301 Jones Bridge Road, 
Bethesda, MD. 


EDSIG - the education special interest 
group - will meet on Tuesday, December 14 
at 7:30 PM in Lecture Room A, Building A, 
USUHS. For details of this and other meet- 
ings, see the EDSIG Page elsewhere in this 
issue. 


LOGOSIG meets each month on the Saturday of 
the WAP meeting at 12:30 PM at the Bethesda 
Country Day School, 5616 Beech Avenue, 
Bethesda, MD. 


ASMSIG meets immediately after the regular 
Washington Apple Pi meeting. 


JOB (T)RRT 

HELP WANTED 

The Micro Connection Inc., the Personal 
Computer Store is seeking a part-time 
salesperson to work at the store each 
afternoon (3 pm to 6 pm) and all day Sat- 
urday. The salesperson should have 
knowledge of Apple equipment and software. 
Good opportunity in a pleasant store. Call 
Bob at 281-1866. 


FACULTY TENURE TRACK POSITION IN MICRO- 
COMPUTER APPLICATIONS: In schools, home 
and business for instruction and learning, 
information management, and decision sup- 
port. 

Candidates from a wide variety of back- 
grounds will be considered. Ph.D. is 
required. Rank and salary commensurate 
with qualifications and experience. Ap- 
pointment date: Fall 1983. Inquiries and 
applications should be sent to: Dr. James 
Liesener, Chair, Faculty Search Committee, 
College of Library and Information Ser- 
vices, University of Maryland, College 
Park, MD 20742. 

The Univ. of MD is an affirmative action 
and equal opportunity employer. 


The APPLE /// SIG meets on the second 
Thursday of the month at 7:30 PM. The 
meeting place alternates between the Walter 
Reed Medical Center and Universal Comp- 
puters. 


NEWSIG will meet just after the regular 
Washington Apple Pi meeting. We will 
answer questions and try to help new owners 
get their systems up and running. We will 
also explain how our club operates. 

The following members have agreed to answer 
questions over the phone when someone gets 
stuck and needs help between meetings: 

Bob Chesley 560-0120 
Paul Hoffman 831-7433 
Sarah Lavilla 926-6355 
Boris Levine 229-5730 
Steve Sondag 281-5392 


The Telecomm SIG meets after the regular 
WAP meeting. See the Telecomm SIGNEWS 
elsewhere in this issue. 

*** LAWSIG *** 

WAP member Charles Field and WAP General 
Counsel Jim Burger would like to see if 
there is any interest in forming a LAWSIG. 
Anyone , interested please call Charles at 
work (755-8247) or Jim (822-1093). After 
the next meeting Charles and Jim will be 
meeting with a representative for West Law 
to explore the possibility of accessing 
West Law to the APPLE. 


CACI, INC. in Alexandria, VA has an immedi- 
ate need for an Apple 11+ configured for 
CP/M with keyboard enhancer to do Wordstar 
word processing. We would be willing to 
rent the machine and/or employ someone to 
do the work for a two-three month period. 
Contact Allen Oliver, 841-4444 (day), 593- 
5501 (evening). 


EXPERIENCED APPLESOFT INSTRUCTOR WANTED: 
Electronic Learning Facilitators (ELF) is 
seeking experienced teachers for classes 
beginning in January in Applesoft BASIC, 
business and home applications software, 
and LOGO. All classes are held at our 
Bethesda location in the late afternoons, 
evenings, and on Saturday mornings. Call 
Dianne Lorenz at 530-7881 (evenings) or 
leave a message at 493-9696. 


VOLUNTEER NEEDED 


Trinity College is seeking the help of a 
person with in-depth knowledge of the Apple 
computer to participate in a ’ ' ' 
adapt an Apple for use by a 
student. For additional 
please call Dianne Lorenz 
Monday - Thursday. 


project * to 
handicapped 
information, 
at 269-2315 


<& 




10 


DECEMBER 1982 


WASHINGTON APPLE PI 



r'_j /' 

I l v_ 


b ,y 


J l/* 


i 1 1 Z3 r'”"i lZ 
i v_ 



- _J r Id o i i 


IAC-Apple Computer relations continue to 
improve. Apple has prepared a colorful 
brochure on tne IAC which is slated to be 
included with the literature and manuals 
accompanying each new Apple computer. Ken 
Silverman has arranged a companion purchase 
from their printer of a supply of the bro- 
chures to be used for promotional purposes. 

IAC and Apple Computer have also agreed to 
an arrangement whereby IAC will support and 
seek "adoption" by the appropriate local 
IAC member club(s) of consortiums of not- 
for-profit community service agencies which 
have been awarded grants by Apple to 
network their activities. Recently initi- 
ated by Apple Computer, this new community 
affairs program awards up to five Apple 
computers together with related peripherals 
and software to community agencies wishing 
to share their information collected as a 
part of their community services. Under 
this plan, the IAC member clubs together 
with IAC’s support would provide technical 
backup to the agencies once they received 
the requisite training to be provided by 
Apple Computer staff. 

Some new business items soon to be con- 
sidered by the IAC Board are: 

• Redefinition of what constitutes a user 
group. 

• Special memberships with the IAC with 
differing dues rates and services. 

• Special subscriptions for members of mem- 
ber clubs. 

All member clubs in the Easter region 
should have received by this time a certi- 
fied letter from Santa Clara containing 
nomination foritfs and information pertaining 
to the nomination of candidates for Direc- 
tor, Eastern Region, IAC. (I personally 
stuffed and prepared each envelope.) 


RmeriDmeriT to 
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The WAP Board has become concerned with the 
question of whether SIGs should collect 
dues. The WAP budget allocates funds to 
SIG activities, and the Board believes that 
most SIG activities can be funded through 
these allocations. Each SIG has an initial 
$100 budget, with the Board approving each 
specific expenditure. Additional funds may 
be budgeted as necessary. The Board has 
adopted the following Bylaw amendment to 
clarify that participation in SIGs is not 
conditioned upon payment of dues. 

(New) Article X, Section 4. DUES. No 
special interest group shall collect dues 
or contributions without the permission of 
the Board of Directors. ^ 



In this high-tech world of investing and personal computing, 
is there still a place for dialogue on assets, earnings, and 
growth? There is at IIF. 

Independent Investors Forum is a computer accessed, interactive investment 
advisory service lor those especially interested in long term capital gams. More than 
an electronic newsletter. IIF combines fundamental securities analysis with 
discussions between members and research staff, creating a conference-like setting 
for decision making — yet tree of the constraints of time and space. IIF members can 
read research, offer comments, send messages, and even vote on future research 
topics — at their convenience, without leaving their homes or offices. 

• Emphasis on fundamental analysis and long term growth. 

Not a data source, but a service that analyzes data. 

• Available via GTE Telenet to investors with a 
computer or terminal and communications interface. 

• Limited to 500 members to protect the value of the 
information for each individual 


Independent Investors Forum 

1640 Argonne Place, N.W 
Washington, D C. 20009 
202-667-6628 1719 

"Our advice is questionable!" 


An investment advisory 
service registered with 
the Securities and 
Exchange Commission 


A Christmas Special from VF ASSOCIATES: 
100% Apple-compatible DISK DRIVES 
Ouentin Research — 

ft 

• • 



- one time group purchase 

- place order by Nov. 29 

- payment received by Dec. 8* 

- pick up at W.A.P. meeting orfftDec. 18 
(add $5 if shipping is required) 



*** 

*** 


’If we can't sell it for less, *** 
we don't sell it at all." *** 


- 16K RAM cards (for PASCAL, etc.) $61 

- Lower case chips $20 

- Disk controllers $70 

- CCS Serial Interface cards $125 

- Rana drives $350 

- Rana controllers $115 

- M&R Sup'r Switcher Power Supply $225 

- Double density, double-sided (for 
APPLE) guaranteed diskettes, $1.80 ea 

- Printers available soon 


6327 Western Ave., N.W. 
Washington, D.C. 20015 


363-1313 
(a.m. & eves) 


1 1 


WASHINGTON APPLE PI 


DECEMBER 1982 



■50F TV I 6.LU5 

by David (Do rganste i n 


BIG MAC (written by Glen E. Bredon, dis- 
tributed by CALL A.P.P.L.E.. 304 Main Ave. 
S., Suite 300, Renton, WA. 98055). Perhaps 
one of the best sources for low cost, high 
quality software is the CALL A.P.P.L.E 
group in Washington State. This macro 
assembler is yet another of their excellent 
roducts. Before a summary of its fea- 
ures, be aware that you must be a member 
to buy CA software. However, membership is 
well worth it! 

This macro assembler costs less than many 
commercial assemblers without macro capa- 
bility. The documentation is clear and the 
utility support programs are icing on an 
already wonderful cake. BIG MAC itself 
operates in one of several modes: the EXEC 
mode, the EDITOR mode or the ASSEMBLER 
mode. 

The EXEC mode allows you to load and save 
source files, object files or text versions 
of source files. It allows you to CATALOG 
disks, APPEND source and change the default 
drive. 

The EDITOR for creating assembly language 
source has all of the edit features of the 
PROGRAM GLOBAL LINE EDITOR, also dis- 
tributed by CALL A.P.P.L.E. and also a bar- 

§ ain. It allows for the insertion and 

eletion of text, the modification of text 
either in one line or in many lines, the 
location of text throughout your source 
file and the displaying of lines with or 
without line numbers. During line addi- 
tion, line numbers are provided for you as 
are tab stops if you desire by simply hit- 
ting the space bar (this makes the entry of 
assembly language much easier). 

The assembler provides a symbol table and 
accepts all of the standard directives as 
well as a host of other unusual and valu- 
able ones. With the PUT directive, for 
example, (found only in the Language Card 
version) you can insert a file during 
assembly to increase the effective size or 
your source. BIG MAC allows the programmer 
to define macro routines with variable 
parameters at the beginning of the source 
code. Thereafter, you can reference the 
macro name and include the parameter; the 
assembler will correctly assemble the 
corresponding object code. For example, 
you may define a routine for sending a 
message ending in 00 to the screen. Then 
you can give the name of the macro with 
different messages throughout your code. 
Yes, this can be done by defining a sub- 
routine which you call whenever needed; the 
point is that it is easier and clearer to 
use a macro assembler to do this. Other 
useful macro routines might be to position 
the cursor at a given row. column or to 
read the keyboard. BIG MAC comes with a 
macro library of all of these as well as 
many other useful routines, along with 
example usages of macro capability. 


The manual is 72 pages in length, easy to 
follow and includes a quick reference com- 
mand summary card. It contains important 
rogrammer information and key locations 
ncluding a memory map. All the utility 
programs included on the disk are ex- 
plained. These include a dissassembler 
which creates source files for BIG MAC, the 
SUPPLEMENT which gives Apple 11+ users the 
step and trace functions and a symbol cross 
reference lister (language card version 
only). The Language Cara version of BIG 
MAC uses the extra T6K to allow you larger 
source/object files. 

All in all. it is an unbeatable buy at only 
$22.50 ($28.50 for the Language Card Ver- 

sion) to CALL A.P.P.L.E. members. 


Apple Flasher (written by Paul Mosher, dis- 
tributed by Crow Ridge Associates, Inc.). 
If you think this is an R-rated game which 
comes in a plain brown rain-coat, you* re 
wrong. Flasner is a graphics utility for 
assembling a slide show of Hi-res displays. 
The package (which comes on a protected 
disk) begins by asking you to insert the 
"PIX DISK”. Referring to the seven page 
manual indicates that this means to insert 
your own disk with Hi-res pictures. The 
next screen displays the names of binary 
Hi-res screens and allows you several 
options: display one of the pictures, scan 
through them all, set up a "slide show" 
display where you can move forward or 
backward through the screens or automati- 
cally cycle through the pictures allowing 
varying amount or time for each display. 
By modifying a few normally unused bytes in 
the display file, you can program the dis- 
play period. The best feature of the 
program is the high-speed BLOADs of Hi-res 
screens: about 2-3 seconds each!!! If you 
need a slide show routine, the Apple 
Flasher at $34.50 may be just the thing. 


Bug Byter (written by Ted Cohn, distributed 
by Computer-Advanced Ideas, Inc., 1442A 
Walnut St., Suite 341, Berkeley, CA 94709). 
If you are trying to learn assembly lan- 
guage, or do a lot of machine language 
coding, you will find Bug Byter to be an 
extremely useful utility. Supplied in Dos 
3.2 form (which can be MUFFIN^ed to 3.3) » 
this $1A00 byte, relocatable program can be 
used to provide a visual display of machine 
code in action. The display has to be seen 
to be appreciated. It includes: the con- 
tents of the 6502 registers and program 
counter, the individual bits of the status 
byte, the stack around the current stack 
ointer. a disassembly of the current loca- 
ion, individual memory locations of your 
choice and user definable breakpoints. BB 
returns the step, trace and mini-assembler 
features lost to Apple 11+ owners. You can 
watch the registers, stack pointer and 
status word change as you step through your 
program or trace its operation and at a 

contd. on pg 21 
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We give? discounts of 20-257. and more on ail your hardware and software 
needs . 


N e w r e 1 e a s e s , i. n 

stock, for 
Li st 

y o u r h o 1 i d a y g i. f t 1 :i. s t s 
Sale 

Li st 

Sale 

Frogger 

34.95 

26 , 50 

Spy’s Demise 

29 , 95 

22. 75 

The Artist 

79,95 

59.95 

Type Attack 

39.95 

30. 95 

K n o w Y o u r A p p 1 e 

34. 95 

26 . 50 

Canyon Cl i mber 

29 . 95 

O *"> t's 

Si si II \J U 

A z t e c A d v e n t u r e 

39.95 

30. 95 

Mask of the Sun 

39 . 95 

30. 95 

T ub e way 

34 . 95 

26 . 50 

Ar cade Mac h i n © 

JSJ9 u CpKij 

39 . 50 

Trak Ball 

64 . 95 

48. 75 





W i I d c a r d < h a rdw a r e c o p y i n g dev i c e ) C a .1. 1 f o r p r .i c e 


DECEMBER SPECIALS: 

Buy any .printer at our regular discount price and get the 
Grappler* Interface for $122.50 (list-$165, our req . — $ 1 29 ) 

Buy two games at our regular low price and take an extra 107. off 
our regurlar price on a third game,, 

V i S i (... a .1. (... H H » . « ,1 II II » M ,1 II II II II II II II II II II II H II If N H H II II *|i 1 / \ j H 0 0 

Screenwi ter IX » „ „ $92.. 00 

Super Text II $1 15. 00 

Letter Perfect . „ „ $! 12.50 

(3 u e n t in A p p 1 e M a t e D i s k D r i v e „ $ 2 IB 5 .. 0 0 

IB Joysticks „ $42. 00 

A s a 1 wsys 5 

Ni btal es Away I I $40, 00 

Locksmi th $75. 00 

Verbatim Diskettes 

SS/DD Soft box .......... $25.00 

Hard case $27. 00 

DS/DD Soft box $37.00 

H o 1 i d a y P a c k < 1 0 d i s k s ,, SS/DD, p 1 us h e a d c: 1 e a n i n g k 1 1. » . . $ 3 0 . 0 0 

Li brary cases $2. 25 

FI i. p N File $23.50 

If you don’t see what you want listed, please cal. I for prices ...... 

We carry some books now. Call for prices 

Do you have a friend who owns an Atari, IRS 80, IBM, or any other- 
computer or the Atari Video Computer System? We now carry software to 
support their equipment also. Pass our name along to them. 

d Ihi COMPUTER E> SEE INI 

11716 KEMP MILL ROAD 
SILVER SPRING, MARYLAND 20902 
301-649-6868 


Sunday-Thursday, 10 A.M. — 9 P,M. 

Free delivery to Crystal City UF'S shipping $4.00 extra 

Quantity Discounts Available 

********************** *************** ******************** ************* 
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Some of the mysteries of FILE CABINET and 
its use of sequential text files can be 
explained using an editor program. The 
editor portion of the DOS TOOLKIT, SCREEN- 
WRITER ] I , or most any other word processor 
can be a valuable tool for discovering the 
secrets of the files used. 

The first step is to copy the FILE CABINET 
files; BASENAMEFILE, XXXXXHEADERFILES. and 
XXXXXINDEXFILES onto a blank disk. If you 
are not sure how to do this, see Appendix J 
of the DOS REFERENCE MANUAL. It explains 
the use of FID, a handy text file utility 
which you received as part of the DOS pack- 
age. With the original disk in a safe 
place, we can feel comfortable experiment- 
ing with data that we are familiar with, 
ana not be concerned if it accidentally 
gets clobbered. I will be discussing the 
files we created in the FILEHANDLER article 
in the September issue of the WAP News- 
letter. You can use any of the files 
created by FILE CABINET and and get similar 
results. 

Start your EDITOR program using the normal 
procedures. If you are using the EDITOR 
from the DOS TOOLKIT, you will want to 
replace the tab character, a space, with 
some other character not used in your FILE 
CABINET files. A comma (,) is a good 
choice, since the comma is not usually 
accepted as input from the keyboard; 
rather, it is used as a separator by the 
Applesoft input routines. Now load the 
BASENAMEFILE copied earlier. You will see 
something similar to: 

3 

WAP NEWSLETTERS 
SOFTALK 
DOG RECORDS 

The first line contains only a 3. This is 
the number of database files on this disk 
available to FILE CABINET. The remaining 
three lines are the actual names of the 
databases. In this case there is a file 
for WAP NEWSLETTERS, SOFTALK magazine 
articles, and one for my wife's DOG 
RECORDS. This is where FILE CABINET looks 
when first run. File Cabinet discovers 
there is no BASENAMEFILE on the disk, and 
an ONERR statement directs FILE CABINET to 
a subroutine which will prompt the user for 
the information it needs to construct a new 
database. If the BASENAMEFILE is there, it 
is used to present the "SELECT A DATABASE" 
section of the program. If we were to use 
FILE CABINET to create another database, 
say RECORD ALBUMS, it would write the new 
BASENAMEFILE as: 

4 

WAP NEWSLETTERS 
SOFTSIDE 
DOG RECORDS 
RECORD ALBUMS 

This can be verified using the EDITOR 


I L£ CRB I D£T 
WITH R WORD 

J . T . D elTla y Jr 

program. 

Now that we know the format used for the 
BASENAMEFILE, let's read the WAP NEWS- 
LETTERS HEADERFILE. Surprise, this file is 
in the same format as the BASENAMEFILE. 
See below: 

5 

TITLE 

SUBJECT 

DESCRIPTION 

ISSUE 

PAGE# 

In this case, the 5 in the first line is 
the number of HEADERS or FIELDS in each 
record. The remaining lines are the 
HEADERS which describe the fields in each 
record. You might also expect the INDEX- 
FILE to be of the same format. Well, there 
is a difference as we will see when we read 
the WAP NEWSLETTERS INDEXFILE. Reproduced 
below is a typical example: 

69 

APPLES GO TOPLESS 
COOLING A HOT APPLE 
REMOVE THE TOP TO COOL 
SEPT 1982 
37 

BEGINNERS GUIDE 
SYSTEM MASTER DISK 
WHAT & HOW TO USE IT 
OCT 1982 
24 

COMMUNICATION W/APPLE II 
MODEMS & STUFF 
HOW TO TRNSMIT & RCV DATA 
JUNE 1982 
16 


MORE ENTRIES HERE 


VISICOLUMN 

VISICALC SPREADSHEET 
WHAT IT'S ALL ABOUT 
JULY 1982 
12 

It may be convenient to obtain a hard copy 
of this file for further study. Using the 
information in the HEADERFILE, we can 
determine just how many fields are in each 
record. In our case, there were 5. If we 
count the lines in the INDEXFILE, we should 
come up with a number minus one, which is a 
multiple of 5. The odd line is the first 
line in the file; it is the total number of 
records in this file (69). Lines 2 thru 6 
are the data for record #1; lines 7 thru 11 
are the data for record #2 etc.. 

FILE CABINET uses nested FOR... NEXT loops 
to read the data for each record from the 
INDEXFILES. For example: 


contd. on pg 21 
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********************************************************************* 

•K 

* 

•K 

! WINTER TUTORIALS 

« 

* 

Si. AN INTIMATE COURSE IN BASIC 

* 27^s is a problem-solvvng course ^n Applesoft Bas%c. Six 1-1/i 

* hour teaching sessions with take-home assignments . !F/ie course 

* is designed for a maximum of 10 individuals who have some 

* familiarity with Applesoft and are ready for a second course 

* toward gaining mastery . The class will meet in Germantown , 

* Maryland on Tuesday evenings , 8-9:30, January 18 through 

* February 22 and be taught by David Morganstein. 

J Fee - WAP member , $95.00 non-member, $110.00 

* 

* 

£ 2. PRACTICAL PROGRAMS UTILIZATION - What They Do, How to Use Them 

* For home and business users ; a hands-on, get-acquainted course 

* on CPM and non-CPM versions of word processors/text editors, 

* data base management programs and electronic spreadsheet 

* programs . The seminar will be held in Montgomery County on 

* Saturday, January 8 and 15, 9-4:30 pm. and be taught by Jerry 

* Trowbridge . Mr. Trowbridge , President of Advanced Data 

* Communications , Inc., has been teaching computer and data com - 

* munications courses for Fairfax County Adult Ed. Dept, for 5 

* years, and runs a computer communications engineering firm wit} 

% a micro turnkey business systems division. 

* Fee - with computer, $100.00 without computer , $120.00 


If you wish to attend one or both of these courses, please fill out 
the form below. Enclose check or money order made out to L. 
Morganstein Consultants. You will receive confirmation of regis- 
tration within 2 weeks. Mail form to: 

L. Morganstein Consultants 
13329 Woodruff Court 
Germantown, Maryland 20874 
(301 972-4263) 


Name 


Home phone # 


Addre s s 


Work phone # 


WAP # 


(if applicable) 


I will/will not bring and be responsible for computer, monitor and 
disk drive for the Practical Programs Utilization course. I under- 
stand that if I do not choose to bring a machine, I will look on 
with someone who does. 


Please check 


Intimate Course in Basic 
Practical Programs Utilization 
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Okay, you’ve just bought the WAP FIG-forth 
disk and booted it up. Now what? The 
documentation uses expressions like "inner 
interpreter" and "precedence bit" which 
robably make as little sense to you as 
hey did to me the first time I encountered 
them. While this article won’t go into 
Forth internals in detail, I would like to 
explain some elementary Forth and answer 
some WAP members* requests to "get me 
started in Forth!" 


more spaces or by a carriage return. 

Many Forth words pop numbers off the stack 
and/or leave numbers on the stack. The 
word *+*, for example, pops the first two 
numbers, adds them, and leaves the sum as 
the new TOS. To get the sum of 5 and 8, 
enter the following (remember the spaces 
between each Forth word!): 

5 8 + . 




There are four main components of a disk- 
based Forth system: the data stack (some- 
times called the user’s stack), the return 
stack, the dictionary and the disk screen 
area. 


THE DATA STACK 


The data stack is a pushdown stack which 
holds signed 1 6-bit numbers. Certain stack 
operations treat a pair of these numbers as 
a single 32-bit number; they usually begin 
with the letter "D" and we’ll ignore them 
here. You can think of a pushdown stack as 
a black box into which you can put numbers 
and out of which you can take them subject 
to the restriction that the order in which 
the numbers come out is the opposite of the 
order in which they went in: the last one 
in is the first one out. Numbers are 
pushed onto the data stack by simply typing 
them. (In all the examples that follow, it 
is assumed that each line ends with a 
carriage return.) For example, 

12 3 4 5 


will push the integers 1,2, 3, 4 and 5 onto 
the stack. Since the number 5 was the last 
one pushed, it is said to be "on the top of 
the stack." The number 4 similarly is the 
"next on the stack." These two expressions 
are frequently abbreviated TOS and NOS. 
The Forth word *.* (pronounced "dot") pops 
the TOS off the stack and prints it. So 
enter a period now (followed as always by a 
carriage return) . The number 5 should 
appear on the screen. To print out the new 
TOS and NOS, enter two periods separated by 
a space. Notice that 5 is no longer on the 
stack - it was popped off before it was 
printed. Now the 3 and 4 have been popped 
off too, and the stack contains 1 and 2, 
with 2 as the TOS. Attempting to pop ofr 
more numbers than are on the stack gets you 
error message #1 - nothing left on the 
stack (technically called "stack under- 
flow"). Similarly, attempting to push more 
numbers onto the stack than it can handle 
gets you error message #7 - stack over- 
flow. (This implementation of Forth can 
stack a maximum of 63 16-digit numbers. 
The stack begins at $DE and grows down to 
$ 60 .) 


In the example, the two ’dots’ had to be 
separated by a space. This is an example 
of a general rule in Forth that individual 
words must be followed either by one or 


THE RETURN STACK 

Like the data stack, the return stack is a 
1 6-bit first-in last-out data structure. 
The Forth inner interpreter (that part of 
Forth which executes previously defined 
words) uses this stack to store return 
addresses as it interprets words. Exactly 
how it does this is explained in more 
detailed references. The return stack is 
available to the Forth programmer through 
the words ’>R* ("to R"), which pops the 
data stack and stores the number at the top 
of the return stack, *R>’ ("R from") which 
does the opposite, and *R’ which pushes the 
top of the return stack onto the data 
stack, but leaves the value on the return 
stack as well. These words are usually 
helpful when you want to set the TOS aside 
for a minute, do some computation on the 
rest of the stack and then get the number 
back. Obviously, if you put a number on 
the return stack and forget to take it off, 
the inner interpreter will eventually think 
it’s a valid return address with spectacu- 
lar though usually undesired effects. So 
each *>R r should be paired with a ’R>’ in 
the same word definition. 

THE DICTIONARY 

A Forth program is just a sequence of 
previously-defined Forth words. When the 
program is run, the inner interpreter 
interprets each of these words by looking 
up it’s definition in the dictionary and 
executing it. Each dictionary entry con- 
sists of four fields: the name field, the 
link field, the code field and the parame- 
ter field. 

THE NAME FIELD - contains the name of the 
word, which may be comprised of 31 or fewer 
characters, Each name is unique in FIG- 
Forth. (This is significantly different 
from many other Forth’s, where the name may 
be any length, but only the length and 
first few characters are stored in the 
dictionary. Thus, for example, the word 
’GETDATE’ might well be identical to 
’GETNAME* ana would then redefine it -- 
probably not what the programmer intended ! ) 
Preceding the name of the word in the Fig- 
Forth name field is a data byte indicating 
the length of the word, its precedence 
(immediate or non- immediate) and whether or 
not the word is smudged. (Smudging a word 
makes it invisible to the dictionary lookup 
routine. A word is usually only smudged 

contd. 
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when it is being defined. ) 

THE LINK FIELD - contains the RAM-address 
of the next dictionary entry to be 
searched. The end of the dictionary is 
indicated by zero in the link field of the 
last word in the dictionary. 

THE CODE FIELD - contains the RAM-address 
of the start of the executable code assoc- 
iated with the word. 

THE PARAMETER FIELD - There are two types 
of words in Forth: primaries and second- 
aries. A primary word is one whose code 
field contains the address of the parameter 
field and whose parameter field contains 
the machine code which carries out the 
function of the word. The parameter field 
of a secondary word, on the other hand, 
usually contains data for the machine code 
addressed by the code field to operate 
with. When a Forth word is defined in 
terms of other Forth words, for example, 
its parameter field contains the code field 
addresses of these other Forth words and 
its own code field routine modifies the 
inner interpreter to execute this list of 
addresses. The exact makeup of the param- 
eter field of a secondary word, of course, 
depends on what its code field code expects 
to be there. This treatment of the Forth 
dictionary is a little sketchy — we* 11 
discuss it more fully in a later column. 

THE DISK SCREEN AREA 

The disk I/O logic of standard FIG-Forth 
treats a disk as a collection of 100 
screens. Each screen consists of 16 lines 
of 64 characters each. (Some quick arith- 
metic reveals that a Forth screen disk can 
hold a maximum of 102,400 bytes. Since a 
DOS 3.3 disk can hold about 139.000 bytes, 
an area approximately 36.600 bytes long is 
wasted on each disk. This was done inten- 
tionally to maintain compatibilty with the 
FIG-Forth "Standard. ") 

This implementation of Forth permits only 
one screen to reside in RAM at a time. Any 
time a new screen must be read into RAM, 
the current screen is automatically written 
back to disk if it has been modified in any 
way. Forth "programs" are usually written 
by using the EDITOR to create screens con- 
taining word definitions and then putting 
these word definitions into the dictionary 
by "compiling" the screens. An example of 
creating and compiling a screen is given 
later. Forth screens are numbered begin- 
ning at zero. The WAP implementation sup- 
ports one or two disk drives. The con- 
troller card is assumed to be in whatever 
slot Forth was booted from. Screens 0-99 
are defined to reside on drive one and 
screens 100-199 on drive two. Thus the 
fifth screen on a disk is #5 if the disk is 
in drive one and #105 if it's in drive two. 

Certain housekeeping tasks have to be 
carried out to make the RAM screen buffer 
ready to receive Forth screens. These 
tasks are performed by the word 'EMPTY- 
BUFFERS* . 

EVERY TIME FIG-FORTH IS BOOTED UP, 'EMPTY- 
BUFFERS' MUST BE EXECUTED BEFORE ANY DISK 
I/O IS ATTEMPTED. FAILURE TO DO THIS 


USUALLY CRASHES FORTH! 

This warning is buried somewhere in the 
documentation and understandably is over- 
looked by many! 

THE EDITOR 

The line-oriented screen editor supplied 
with the WAP FIG-Forth disk is taken 
directly from the FIG-Forth model dis- 
tributed bv the Forth Interest Group. It 
has been placed in the public domain and a 
disk containing the source Forth will soon 
be available from WAP. Hardcopy of the 
ine-oriented editor can be obtained for 
15 (at this writing) from the Forth 
Interest Group, P.0. Box 1105, San Carlos, 
CA 94070. The editor will handle lines up 
o 64 characters long - but folks without 
0-column cards will probably want to keep 
lines to a 40-character maximum. To invoke 
the editor, simply enter the word EDITOR. 
This makes the EDITOR vocabulary the 
context vocabulary - where Forth will look 
first when searching for dictionary words. 
We will use screen #15 - which means that 
we will be writing to a disk in drive #1. 
So before starting the example BE SURE TO 
REMOVE THE FORTH PROGRAM DISK FROM DRIVE 
#1! FIG-Forth's disk 1/0 is strictly 
screen-oriented. It does not know or care 
about DOS diskspace management and will 
happily write over WHATEVER happens to be 
in the designated screen area! Now place a 
newly initialized DOS 3.3 disk in drive #1 
and you're ready to go. 

After entering EDITOR, place the screen 
number you want to edit on the stack and 

then enter either CLEAR or LIST. CLEAR 

clears the stated screen to blanks: LIST 

merely lists it without clearing. Since we 
don't have any text on screen #15 yet and 

we don't know what garbage may be on it, 
we'll clear screen #15. 

EDITOR 15 CLEAR 

To list the blank screen we can enter 
either 15 LIST or simply L. The L command 
is an editor word which lists the screen 
being edited (previously specified with a 
CLEAR or LIST). To enter a line of text 
into the screen buffer, use the command P. 
P tells the editor to place all the text 
that follows it on the same line into the 
line number on top of the stack (TOS). So, 
if we enter 

8 P THIS IS THE EIGHTH LINE. 

L 

and then enter L on a new line, we'll see 
"THIS IS THE EIGHTH LINE." on line 8. 
Notice that P puts everything up to the 
carriage return into the line, so we have 
to give the L command on a new line. Also 
notice the single spaces after 8 and P. 
Now enter 

5 P THIS IS THE SEVENTH LINE. 

Entering L again, we see the new text right 
where we put it. We can move this line to 
line seven like this: 

5 D 7 I 

contd. 
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The D tells the editor to delete line TOS 
(in this case 5) from the screen, hold it 
in a temporary line buffer (which the 
editor calls PAD) and then move all the 
following screen lines up one to cover up 
the blank line. The I command copies PAD 
into line TOS (in this case 7). If you 
want to move line 5 to line 7 without 
moving the following lines up, use the 
sequence: 

5 H 5 E 7 I 

The command H copies line TOS to PAD 
without erasing it. E erases line TOS 
without moving subsequent lines up. Now 
enter the following: 

15 CLEAR 

0 P THIS IS THE ZEROTH LINE. 

1 P THIS IS THE FIRST LINE. 

2 P THIS IS THE SECOND LINE. 

3 P THIS IS THE FOURTH LINE. 

4 P THIS IS THE FIFTH LINE. 

L 

Looks like we forgot "THIS IS THE THIRD 
LINE." in line 3. we can push down lines 3 
and 4 and insert the new line like this: 

3 S 3 P THIS IS THE THIRD LINE. 

• L 

The command S spreads the screen at line 
TOS, moving subsequent lines down one line 
and making line TOS blank. There are a few 
more editor commands, but they are self- 
explanatory and are included in the summary 
later. The other feature of the editor is 
the character cursor. The cursor is used 
to find, delete and replace characters. 
The cursor is represented by an underscore 
character and the line it is currently 
within is printed at the bottom of any 
screen listed using the L command. Enter 
the following short Forth word which 
accepts a positive whole number and prints 
whether it is odd or even: 

1 P : ODDOREVEN CR ." ENTER A POSITIVE 

WHOLE NUMBER " QUERY 0 WORD 

2 P HERE NUMBER DROP DUP ." THE 

NUMBER " . 1 AMD IF ." IS ODD." 

3 P ELSE " IS EVEN." THEN CR CR ; 

L 

Proofreading the screen, we see a typo in 
line 2 - AMD should be AND. Enter the 

following to correct the error without 
having to retype the line: 

TOP 

F AMD 

3 DELETE C AND 

L 

The command TOP places the cursor before 
the first character of the first line. The 
command F places the cursor at the end of 
the first occurrence of whatever text fol- 
lows the F. After entering F AMD and a 
carriage return, we see the cursor placed 
right after the "D" of "AMD" in line 2. 
DELETE deletes to the left of the cursor 
the number of characters on top of the 
stack (in this case 3 - we could have just 
deleted the "M", but deleting the whole 
word makes the example clearer). The 
command C inserts at the cursor whatever 


text follows the C. We can combine the F 
and DELETE functions by using X. X tells 
the editor to delete from the screen buffer 
the first occurrence of the text which 
follows the X. So, instead of the above, 
we could have simply entered: 

X AMD 
C AND 
L 

The cursor can be moved with the command M. 
M moves the cursor TOS characters to the 
left if TOS is negative and to the right if 
TOS is positive. 

SUMMARY OF THE LINE-ORIENTED 
EDITOR COMMANDS 

EDITOR - Selects the EDITOR vocabulary. 

This word should begin all screen 
editing sessions. 

CLEAR - Clears screen number TOS to 
blanks. (See LIST below.) 

LIST - Lists screen number TOS. Either 

CLEAR or LIST should be used to 
identify to the editor what 
number screen you want to edit. 
Using the L command (or any 
editor command, for that matter) 
without first entering CLEAR or 
LIST gives unpredictable results! 

FLUSH - Writes the current screen to 

disk. 

P - Enters the text following the P 

into line number TOS. 

E - Fills line number TOS with 

blanks. 

D - Copies line number TOS to PAD, 

deletes line number TOS and moves 
all subsequent lines up one line. 

H - Copies the line number TOS to 

PAD. Leaves line number TOS 
intact. 

T - Prints line number TOS on the CRT 

and copies the line to PAD. 

R - Replaces line number TOS with the 

line at PAD. 

S - Makes a blank line at line number 

TOS after first moving all 
subsequent lines down one line. 
"Opens up" a line at TOS. If 

line #15 is not blank, this 
command does nothing. 

I - Inserts the line at PAD at line 

number TOS after moving all 

subsequent lines down one line. 
(See note below.) 

L - Lists the current screen and the 

line containing the cursor. 

TOP - "Homes" the cursor. Places 

cursor before the first character 
of line #1. 

M - Moves the cursor TOS characters - 

to the left if TOS is negative 

contd. 
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THE APPLE II STARTER SYSTEM INCLUDES: 


APPLE II PLUS 48 K COMPUTER * DISK II (DISK DRIVE) - GREEN PHOSPHOR 
MONITOR III - MONITOR STAND - LANGUAGE CARD (16 K ADDITIONAL RAM) - 
APPLE WRITER WORD PROCESSING PROGRAM - 15 MONTH SERVICE PROTECTION 

- 4 SYSTEM MANUALS & SYSTEM SOFTWARE 

* AND * 

- OVER 75 PROGRAMS CONTAINED ON 10 DISKETTES 

- FREE ORIENTATION, SET-UP & CHECK OUT AT THE COMM CENTER 


PHONE: 

WASHINGTON & NORTHERN V A. 
BALTIMORE 

COMPUTER BULLETIN BOARD 
(WHEN STORE IS CLOSED) 


953-9535 

792-0600 

953-3341 

792-0305 


THE COMM CENTER 

^cipplc computer 

"©Authorized Dealer 


LAUREL PLAZA 

ROUTE 198, LAUREL, MARYLAND 

OPEN: MONDAY thru FRIDAY 
10 AM to 8 PM 
SATURDAY 
10 AM to 5 PM 


VISA 


i 1 1 

MASTER 

CHOICE 

i 
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and to the right if TOS is 
positive. 

F - Places the cursor immediately to 

the right of the next occurrence 
of the text following F. F scans 
forward on the screen; the 

editor will not search 

backwards. 

N - Finds the next occurrence of 

whatever text F was looking for. 

DELETE - Deletes the TOS characters to the 
left of the cursor. Unlike the M 
command, you cannot delete 
characters to the right of the 
cursor simply by making TOS 
negative. The editor will 

interpret this as a very large 
positive number, with spectacular 
and usually undesirable results. 

X - Deletes the next occurence of the 

text following X from the screen. 

C - Copies at the cursor the text 

following the C. 

TILL - Deletes all characters from (and 
including) where the cursor is to 

(and including) the text 

following TILL. 

NOTE: The choice of the letter "I" for the 
INSERT function in this editor is unfortu- 
nate. "I" in the Forth vocabulary means 
"stack the loop index" and is used fre- 
quently. You can get around this by typing 
FORTH before the I when you create a 
screen, but then you have to enter EDITOR 
again when the word finishes compiling. To 
change the name of the editor’s I to some 
other letter (sav Z) in the RAM dictionary, 
enter the following: 

EDITOR * I NFA 1+ 218 C! 

If you don’t make this change, I can almost 

f uarantee you that, sooner or later, you'll 
orget to precede "I" by "FORTH" in some 
program you're writing. This usually 
causes the program to hang - and you 'll 
have one helluva time trying to figure out 
what went wrong! 

The following example shows how to compile 
the word 'SQUARES' which will compute the 
squares of the integers from 1 to TOS and 
give their sum. 

EMPTY-BUFFERS 

EDITOR DECIMAL 15 CLEAR 

0 P ( 'SQUARES' OF FIRST TOS INTEGERS ) 

1 P FORTH DEFINITIONS 

2 P : SQUARES 1+0 1 ROT SWAP 

3 P DO FORTH I DUP DUP . DUP . + 

4 P CR LOOP CR ." SUM = " . CR ; 

5 P 

6 P ;S 
L 

15 LOAD 

The first line we've already talked about. 
In the second line, EDITOR makes the vocab- 
ulary of the line oriented editor available 
to tne Forth outer interpreter. (We'll dis- 
cuss vocabularies in a later column.) 
DECIMAL tells Forth to input and output 


numbers in base 10. 15 pushes a 15 onto 

the data stack. CLEAR instructs Forth to 
clear the screen whose number is on top of 
the stack (TOS) - in this case 15. In the 
third line, P instructs Forth to place all 
the text that follows (up to the carriage 
return) into the line whose number is TOS 
(in this case 0). Similary, the fourth 
line tells Forth to place that text into 
line 1 of the screen, and so on. The ;S in 
the ninth line tells the screen interpreter 
to stop interpreting and return control of 
Forth to the keyboard. The tenth line 
lists the screen so you can see if every- 
thing looks right. In the eleventh line, 
LOAD tells Forth to compile the screen 
whose number is TOS. If the screen con- 
tains any errors, appropriate error 
messages will be generated. Otherwise the 
word 'SQUARES' will be added to the dic- 
tionary in the vocabulary FORTH. Assuming 
the word compiled correctly, we can compute 
the sum of the first sixteen squares by 
entering the Forth words: 

16 SQUARES 

If the word compiled okay, you will notice 
that Forth doesn't recognize any of the 
editor commands (try to list tne screen 
with L). This is the problem with 'I' that 
I was talking about before. The word 
SQUARES needs the value of the loop index, 
but since the editor vocabulary was still 
the context vocabulary, just entering 'I' 
would be interpreted as the editor command 
to Insert. Entering FORTH before the I 
switches the context vocabulary back to the 
Forth nucleus, giving I the correct inter- 
pretation. But from that point on in the 
compilation and afterwards, Forth is the 
context vocabulary and to use editor words 
again, we need to re-enter EDITOR. (This 
sort of confusion is unnecessary and could 
have been avoided by the choice of some 
other letter for the editor Insert!) 

As you can see, line 0 of screen 15 con- 
tains a comment (enclosed, as all comments 
must be, in parentheses) giving the name of 
the major Forth word or words defined in 
the screen. This is the customary use for 
line 0 of any screen, since the word 
'INDEX' will list line 0 of every screen 
from NOS to TOS, making it easy to see what 
screens are used for what purposes. Note 
also that there is a space after the left 

P arenthesis. The left parenthesis is a 

orth word indicating that all the text on 
that line up to ana including a right 
parenthesis should be treated as a comment 
and ignored by the interpreter. Since ' ( * 
is a Forth word, it must be followed by a 
space. 

The EDITOR works on whatever screen is in 
the screen buffer at the time. To bring 
another screen into the buffer, enter 

nnn LIST 

where nnn is the screen number you want. 
Before screen nnn is brought into memory, 
the old screen will be rewritten to disk 
automatically if it has been. modified. If 
you just want to write the current screen 
to disk without bringing in a new one, 
simply enter the word 'FLUSH'. 

contd. 
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ERROR CODES 


The FIG-Forth error codes were inadvert- 
ently left out of the original disk- 
resident documentation. Forth outputs its 
error codes according to the base you 1 re in 
- i.e. the code for CONDITIONALS NOT PAIRED 
would print as #19 if you* re in decimal 
mode, #13 if you* re in hex, #10011 if 
you’re in binary etc. They are listed here 
in decimal: 


0 - WORD NOT IN DICTIONARY or CAN’T 
CONVERT NUMBER 


1 


2 


4 


7 


17 


EMPTY STACK - Some Forth word needed 
a number on the stack and the stack 
was empty. 


DICTIONARY FULL - No more room in the 
dictionary; cannot complete the word 
being compiled. 


NAME ISN’T UNIQUE (Note this is a 
warning message only - it appears 
during compilation to let you know 
that the name of the word being 
compiled is already in the dictionary 
- possibly in another vocabulary. 
The new word, however, will be 
compiled. Any subsequent words whose 
definitions include this new word 
will be compiled with the new defini- 
tion. but words already compiled will 
retain the previous definition. 


FULL STACK - Some Forth word wanted 
to put a number on the stack but the 
stack was full. This FIG-Forth uses 
a stack which is decimal 127 bytes 
deep. The stack begins at location 
$DE and ends at $60. 


THIS WORD MAY ONLY BE USED WITHIN A 
COLON DEFINITION 


18 - THIS WORD MAY ONLY BE USED IN EXECUTE 
MODE 


19 - CONDITIONALS ARE NOT PROPERLY PAIRED 

20 - DEFINITION IS NOT FINISHED 

21 - WORD YOU WANT TO FORGET IS IN PRO- 

TECTED DICTIONARY 


SOFTVIEWS contd. from pg 12 

speed of your choice. You can switch the 
display to the Hi-res screen. 

Since the code is relocatable, you can load 
it into a 16K memory card and execute it 
there to trace machine code which runs in 
the ’’lower 48”. Had enough? There’s 
more ! ! ! You can issue DOS commands while 
BB is running, jump to the monitor and 
return to BB where you can change regis- 
ters. The ASM command enters a mini- 
assembler like the one in the non-autostart 
ROM. You can convert hex to decimal and 
vice versa. There is a hex/ASCII memory 
dump feature which can be paged through 
memory. You can modify memory by supplying 
either the hex or ASCII data you want 
inserted. The ASCII can come with either 
the high bit on or off. Whew... the 
displays of registers can be either in hex 
or binary. 

Folks like Chuck Mesztenyi will be inter- 
ested to know that BB will display the 
number of cycles which have passed since 
its cycle counter was reset. This allows a 
programmer to optimize code. The 40 page 
manual is well written, easy to understand 
and begins by examining a simple example 
program contained on the unprotected disk. 
BB costs $47.50 and as far as I know has no 
competitors. It is a unique and valuable 
tool. & 


INSPECTING TEXT FILES contd. from pg 14 

FOR X = 1 TO NR 
FOR Y = 1 TO NH 
INPUT R$(X,Y) 

NEXT Y 
NEXT X 

where NR is the number of records, and NH 
is the number of headers. R$(X,Y) is the 
two dimension array variable for each field 
(Y). in each record (X). This is a very 
efficient programming technique and should 
be considered whenever there is a large 
amount of data to retrieve. 


22 - THIS WORD MAY ONLY BE USED WHEN 
LOADING 

I hope the above ramblings have been of 
some help in helping you get started in 
Forth. Some good references on Forth are: 

1. BYTE . Vol. 5 No. 8 (August 1980) 

P-QJahg A a 


2. Dr*. 

(September 

3. Brodie, Leo: 


al , Vol. 6 Issue 9 

For th, Prentice- 


Brodie, Leo: Starting For th, Pre 
Hall, Englewood Cliff s , N J , 1981 

4. Derrick and Baker: JLQfiUHL gnayclppedia 
Mountain View Press, Mountain View, CA, 
1982 

5. Loeliger , R.G.: Threaded Interpretive 

Languages , Byte Publications Inc., 70 
Main St. 7 Peterborough, NH 03458 € 


Armed with this information and an EDITOR 
program from a word processor, it may be 
possible to reconstruct a BASENAMEFILe, or 
a HEADERFILE, and save a database which was 
inadvertently clobbered. 

These same techniques will work with any 
sequential text file written using normal 
DOS. Random access text files present a 
different problem. When reading a random 
access text file with a text editor, only 
the first record will be read in. I sus- 
pect that the EDITOR reads text files 
looking for two or more "empty” bytes as a 
signal that it has reached the end of the 
file. Some character must be used as a 
stop bit, a null perhaps, or else the 
EDITOR would read the entire disk. Pro- 
grams that use random access files must 
keep track of the exact record length, as 
well as the number of records; but that's 
food for another article. * 
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CALL 


JOHN 


JAN 


( 202 ) 364-0273 


• VISA. MC add 3% (Include card no. and expiration date) 

• Allow 3 weeks lor personal check to clear 

• COD'S require 10% deposit— all COD charges to be paid by customer 

• Prices subject to change without notice— all items subject to availability 

• Money order, certified check, cashier's check or bank wire deposit accepted 

• Include lull telephone number on all mail orders 

• Include $2 50 lor postage and handling per software shipment (UPS) 

• DC residents add 6% tax (if tax exempt. Include number). 
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Description 


List $ 


Sale $ 


HARDWARE 

New Specials 


Davong 5mb hard disk 
Includes cables, card 


and software: 

1,995.00 

1,495.00 

IDS 

Prism 132 

Color option 

1,696.00 

399.00 

1,395.00 

299.95 

Microtek 

Parallel Card 

130.00 

89.95 

Practical Peripherals, Inc. 

Buffered Interface Graphic Cards 

Epson — 16k 259.00 

PC8023 — 32k 299.00 

IDS — 32k 299.00 

209.95 

239.95 
239.00 

Videx 

Function strip for 

Enhancer II 

79.00 

64.95 

Monitors 



BMC 

12" green: 15MHz 
a best value 

99.00 

87.95 

Amdek 

12" Video 300G 18MHz 

249.00 

149.95 

Dot Matrix Printers 


Okidata 

ML83A 

995.00 

745.00 

NEC 

PC-8023 

645.00 

479.95 

Impact Printers 



C. Itoh Starwriter 

40cps 

55cps 

1.995.00 

2.595.00 

1.595.00 

1.895.00 

Surge Protection 


Kensington 

System Saver 

89.95 

74.95 


Also available 

Modems 
Interlaces 
Disk drives 
Accessories 
Terminals 
Peripherals 
Joysticks 
Paddles 
Keypads 

and, hundreds more! 


Description 

List $ 

Sale $ j 

BUSINESS 

Data Managers 

dBASE II with ZIP 

700.00 

459.95 

DB Master 

229.00 

149.95 

Utility pac #1 

99.00 

74.95 

Utility pac #2 

99.00 

74.95 

General Manager 

149.95 

119.95 

PFS 

95.00 

74.95 

PFS: Report 

125.00 

94.95 

PFS: Graph 

125.00 

94.95 

Versaform II 

389.00 

289.95 

Versaform II — Hard disk 

495.00 

379.95 

VisiFile 

250.00 

179.95 

Accounting 9 

Accounting Plus 

425.00 

299.95 

Accu-Ledger 

495.00 

379.95 

Business Bookeeping System 

395.00 

294.95 

E-Z Ledger 

60.00 

44.95 

General Ledger w/Payables 

495.00 

379.95 

Payroll 

395.00 

294.95 

Receivables 

495.00 

379.95 

1 Financial Modeling & Planning 


Asset Manager 

200.00 

149.95 

Budget Planner 

150.00 

119.95 

Business Forecasting Model 

100.00 

79.95 

CalcStar 

195.00 

114.95 

Desktop Plan II 

250.00 

179.95 

SuperCalc 

295.00 

199.95 

VisiCalc 3.3 

250.00 

179.95 

VisiTrend/Plot 

300.00 

219.95 

Presentation Aid 1 

I Executive Briefing System 

199.00 

139.95 

Project Planning & Scheduling 


Time Manager 

150.00 

119.95 

VisiSchedule 

300.00 

219.95 

Plus 



Communications 

Graphics 

Mailing lists 

| Property Management & Real Estate 


Statistics 

Tax 

Word Processors 

Spelling Checkers 

and much, much more! 



COLUMBIA COMPUTER SYSTEMS 

OVER 3000 PRODUCTS AVAILABLE 

The largest & oldest supplier of Computers, Peripherals, & Software 
in the Washington, D.C. Area 

Mail your orders to: P.O. BOX 40813, Washington, DC 20016 
or call (202) 364-0273 any time, day or night 

We deliver to the Washington Apple PI meetings; call for details. 
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T£CH nOT£5 

by €_ d 5 c h e n k e. r 


I am pleased to announce that Lance Bell 
has agreed to take calls from our friends 
in Virginia. Lance, who lives in Newing- 
ton. has all the necessary information 
available to him. He can be reached during 
the evenings at 550-9064. Thank you, 
Lance. 

Since the majority of calls have come from 
Apple III owners, this month* s column will 
be devoted to the Apple III . 

ITEM 1 : There is a slight timing problem 
when the Apple ][ Parallel Printer Inter- 
face is used in an Apple ///. The Notes 
recommend that you use the Universal 
Parallel Interface, since it works in both 
Apple /// mode and Apple J[ emulation mode. 
Tne Apple ][ Parallel Printer Interface can 
be made to work with the addition of a 
0.001 microfarad capacitor between pins 4 
and 7 of chip B2, a 74LS74. 

ITEM 2: The Super Serial Card can be used 
in the Apple III with the appropriate 
driver. The Apple III is an interrupt 
driven system, so switches S2-6 and S2-7 
must be on to enable interrupts from the 
card. The Apple III will hang when the 
driver is initiated and this is not done. 

ITEM 3: There is no way to control the 
number of stop bits sent out by the RS-232 
driver. It will send out one stop bit 
except at 110 baud, when it sends out two. 

ITEM 4: The section on the Universal Par- 
allel Interface deals mainly with the Epson 
MX-80 printer. In the UPIu manual, table 
4-2 on page 19 can be used for table 2-2, 
which was inadvertently omitted on page 10. 

ITEM 5: The Epson printer will not work 
properly with an Apple ][ Parallel Inter- 
face cable. On page 8 of the UPIC manual, 
there is a cable specified in table 2-1. 
This cable must be wired. 

ITEM 6: The switch on the UPIC must be set 
to auto. 

ITEM 7 : Also , refer to table 4-2 on page 
19 of the UPIC manual in order to set the 
values of the SOS driver configuration 
block for the Epson MX-80. 

If you have any particular problem or ques- 
tion that might be answered from the Tech 
Notes. don*t hesitate to call me at 
977-7349. If you live in Virginia and wish 
to avoid a long distance charge please con- 
tact Lance Bell at 550-9064. A 


fflRK I no B€TT€R 


D I SK COP ICS 
by David 
mo rgansto i n 

Have you ever made a back-up copy using the 
C0PYA program on your Master Disk only to 
find that a later access of the disk yields 
the abhorrent ”1/0 ERROR” message? Even 
more mysteriously, has this happened even 
though you did a CATALOG of the back-up 
lust after COPYA was finished? If so, the 
following advice is for you! 

As many readers are aware, COPYA first 
reads eight tracks from the original and 
then initializes the back-up. Tne tracks 
read from the original are stored in memory 
and then written to the back-up. The pro- 
cess of reading and writing eight tracks is 
repeated four times (transferring 32 
tracks) followed by a shorter read and 
write of the remaining 3 tracks. Usually 
this does it. Unfortunatly , if the back-up 
was not perfectly centered when the drive 
door was closed, the writes to the disk 
will be off center. After the copy process 
is complete, the disk can be CATALOG* ed so 
long as it remains in the drive. As the 
disk spins, off center, the head can track 
the data. 


However, when the disk is removed and re- 
inserted, the off-center pattern can not be 
re-established and the disk is unreadable. 
Therefore, to check that a copy is good, 
remove it from the drive and reinsert it 
before performing the CATALOG. 


More importantly, to prevent the off- 
centering of tne disk to begin with, try 
the following. When inserting the back-up 
disk, don*t close the door. Run COPYA, 
after the original disk is read and as the 
back-up begins to spin, close the drive 
door gently. Waiting for the disk to begin 
spinning helps insure that it is centered 
and that the data will be written in 
repeatable circles. $ 


BUGS ACID OTIH6.R 
PflRAS I TtS 

Mark Crosby submits the following regarding 
Screen Writer II: 

When using the Get Buffer with a virtual 
file (file bigger than memory - you can 
tell this by an inverse number in the lower 
right screen), an irretrievable 1/0 error 
will occur if you are using the same drive 
for your input and output file. To avoid 
this, use a different drive for your input 
and output. If you have only one drive, 
don't use the Get Buffer under these condi- 
tions until a corrected version of Screen 
Writer comes out (soon, we're told). . 
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Q 8 < i~j 

by Bruce F . Field 


The Q&A column in the September 1982 WAP 
newsletter contained a short program to 
allow a user to undelete a file from a 
diskette directory if it had accidentally 
been deleted. As a test I deliberately put 
a small error in the listing to see if 
anyone would catch it. (If you believe 
that, I have this bridge for sale...) Line 
520 should be changed to: 

520 IF S(J) >= 8 THEN S(J) = S(J) 

- 8: BYTE = BYTE -1 

The original only tested for S(J) > 8. 
Thanks to Bob Schmidt for bringing it to my 
attention. 


Q. I know you get this question frequently, 
but here we go again. What is a good 
reference or list of PEEK, POKE commands 
and their functions? I know from Inside 
Apple Pi that the first issue of Apple 
Orchard has such a list, but where can I 
get that issue? Failing that, is there 
a more recent and/or complete listing 
anywhere else? 

A. Unless I'm blind (a distinct possibility 
when it comes to looking for articles in 
magazines) I couldn’t find any PEEK/POKE 
list in Apple Orchard Vol. 1. I notice 
however that Beagle Bros, is offering a 
free PEEK/POKE chart with the purchase 
of any of their software. Actually the 
most complete list I know of is a book 
called "What’s Where in the Apple" by 
William Luebbert. It's published by 
MICRO INK, Inc. (the same people that 
publish MICRO magazine) and is probably 
available in the local computer stores. 
This book lists the information two 
ways, first by numerical memory 
location, and second by names commonly 
used for Monitor, Applesoft, or DOS 
routines. Also another book "Apple II 
Monitor Peeled" contains information on 
how to use the Monitor routines, such as 
writing to the screen, reading the 
keyboard, using lo-res graphics, etc. 


Q. If I accidentally type ]NEW how can I 
recover my program? 

A. This is easy to do, but hard to explain. 
Applesoft stores information in memory 
in the following format. Each character 
group represents one byte in memory. 

AIL A1H L1L L1H TO T1 T2 ... 0 
A2L A2H L2L L2H T3 T4 . . . 0 


additional zeros are stored at the end 
of the program. Normally Applesoft 
starts storing the program beginning at 
memory address $801. When NEW is typed 
AIL and A1H are set to zero. To restore 
the program AIL, A1H have to be reset to 
the address of the byte containing A2L, 
that is the address of the byte immedi- 
ately following the first zero. Then 
memory locations $69, 6 a, $6B,6C. $6D,6E, 
and $AF,B0 (low byte, high byte) have to 
be set to the last address of the pro- 
gram plus 2. The end of the program can 
be found by looking for zeros in three 
consecutive memory locations. Add two 
to the address of the last zero and put 
this address in the three pairs of 
addresses listed above. 


A short machine language routine will do 
this for you. Type the following code 
in and save it to disk, then whenever 
you need to recover a program just BRUN 
the routine. 


0300 - 

0302 - 



find start 

of second line 

A2 04 

LDX 

#$04 

E8 

INX 

BD 00 08 

LDA 

$0800, X 

DO FA 

BNE 

$0302 

E8 

INX 


store in $801, $802 

0309- 8E 01 08 STX $0801 

030C- A9 08 LDA #$08 

030E- 8D 02 08 STA $0802 


find end of program, 
setup monitor registers 
to step through memory 


0311- 

86 

3C 

STX 

$3C 

0313- 

85 

3D 

STA 

f 3D 

0315- 

A5 

73 

LDA 

$73 

0317- 

85 

3E 

STA 

$3E 

0319- 

A5 

74 

LDA 

$74 

031B- 

85 

3F 

STA 

$3F 

031D- 

A0 

FD 

LDY 

#$FD 

031F- 

20 

BA FC 

JSR 

$FCBA 

0322- 

B0 

20 

BCS 

$0344 

0324- 

B1 

3C 

LDA 

($3C),Y 

0326- 

DO 

F5 

BNE 

$031D 

0328- 

C8 


INY 


0329- 

30 

F9 

BMI 

$0324 

032B- 

20 

BA FC 

JSR 

$FCBA 


end of program found, 
store address in pointers 
$ 69 , 6A $6b, 6C $$6D,6E 
and $AF,B0 


Each Applesoft line begins with two 
bytes (an address in low byte, high byte 
format) that point to where the next 
line begins in memory. Then two bytes 
for the line number, an arbitrary number 
of bytes for the tokens and variables 
names, and finally a zero. The zero 
indicates the end of the line. Two 


032E- 

0330- 

0332- 

0334- 

0336- 

0338- 

033A- 

033C- 


A5 3C 
85 59 
85 6b 
85 6D 
85 AF 
E6 3D 
A5 3D 
85 bA 


LDA 

STA 

STA 

STA 

STA 

INC 

LDA 

STA 


$3C 
5S69 
s;6b 
: >6d 

SiAF 
i »3D 
!>3D 
S16A 


contd, 
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033E- 

0340- 

0342- 

0344- 


85 6C 
85 6E 
85 BO 
60 


STA 

STA 

STA 

RTS 


$6C 

j;6e 

J»BO 


Q. I have a Videx Videoterm 80 column board 
with softswitch and would like to use it 
with my Apple Writer 1.0, but it doesn't 
work. How do I get it to work? 

A. Unfortunately you don't. Apple Writer 
1.0 (and 1.1) directly manipulate 
characters on the screen without going 
through any of the standard Apple I/O 
routines. There is virtually no way of 
using an 80 column board unless Apple 
Writer is completely re-written. The 
only solution is to purchase another 
word processor that is compatible with 
your Videx board. 

The latest version of Apple Writer 
(version 2.0) is completely different 
from the original and will work with the 
Sup' R' Term card from M & R Enterprises. 


Q. In the June issue of WAP you wrote that 
every 6 months you dismantle your disk 
drives and clean the heads. My 
questions are: 

1) Would you give step-by-step instruc- 
tions on how to do this? 

2) Are there any other preventive main- 
tenance routines you would recommend, 
for any part of an Apple II system? For 
example, as part of the recent contro- 
versy over whether to use both sides of 
a diskette, someone mentioned "dirt and 
debris" accumulating on the pressure 
pads in the drives. Should they be 
changed periodically? 

A. Let me back off a little bit on cleaning 
disk drives. I disassemble and clean 
mine fairly often, but I am paranoid 
about "dirt and debris", and I use my 
computer about 20 hours a week. My 
opinion is that occasional cleaning is a 
good idea. I do not use both sides of a 
diskette. I have not noticed an 
appreciable accumulation of oxide on the 
pressure pads, and therefore have never 
replaced them. It is possible however 
to get replacement pads at some of the 
computer stores. 

The procedure for disassembling a drive 
is straightforward. 

1 ) Make sure the power is off to the 
Apple. 

2) Disconnect the interface cable from 
the disk controller board. 

3) Remove the four (4) screws from the 
bottom of the drive. 

4) Slide the drive out of the case 
either from the front or the back. This 
is sometimes more difficult than it 
sounds because it is usually a tight 
fit. Also Apple has glued black paper 
on the inside of the case to close off 
the vent slots in the side and the edge 


of the drive may catch on the paper. 

5) Locate the read/write head. The head 

is approximately 1/4" in diameter and is 
located 2" behind the drive spindle. 
Immediately above it is the pressure pad 
which is also approximately 1/4" in /m*. 

diameter and moves down to contact the 

head when the door on the drive is 

closed. 

6) Clean the head. A light touch with a 
cotton swab dipped in isopropyl (rub- 
bing) alcohol is all that is needed. 

You are trying to remove the brown oxide 
coating that accumulates on the head, 
and this usually comes off easily. 

7) Reassemble the drive. Slide the 

cover back on using care not to catch 

the edge of the black paper on the case. 

Put the four screws back in, and attach 
the interface cable to the controller 
card. Be especially careful when 
attaching the cable to the card. If the 
connector is not attached so that every 
pin fits in the right hole in the cable 
socket I guarantee your disk drive will 
be damaged. It is best to take the 
controller card out of the Apple to 
attach the cable and inspect it to make 
sure it is connected correctly. 

Since the Apple is mostly electronic 
there is very little other preventive 
maintenance that can be done. Problems 
with poor contact between the sockets on 
the boards and the chip leads occur, and 
also between the interface cards and the 
expansion sockets. If unexplained hard- 
ware problems occur occasionally, try 
pressing down on all the chips (with the 
power off) to reseat them and remove and 
replace all the interface cards. 


Q. How can one do a dump of memory to the 
screen (or printer) and include the 
ASCII equivalent beside it? 


A. See the listing below. To use this, 
type in the hex code and save it to 
disk. Then BRUN the program and it will 
"hook" into the Monitor via the Ctrl-Y 
command. For example, to display a 
range of memory addresses type 

o00?oFF<Ctrl-Y>. Lower case ASCII is 
converted to upper case before printing, 
and any non-printing control characters 
are replaced by periods. 

Setup ctrl-Y vector 


0 
0 

0305- 

0307- 

030A- 

030C- 

030F- 



03 


F§ 

A9 43 
8D F9 03 

§D FA 03 
60 


LDA #$4C 
STA $03F8 
LDA #$43 
STA $03F9 
LDA #$03 
STA $03FA 
RTS 


0310- A5 3C 
0312- 29 07 
0314- DO 30 


LDA 

AND 

BNE 



finished with hex digits 
now do ASCII 




contd. 
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Q. 


A. 


0316- 

A8 


TAY 

°3 17— 

38 


SEC 

0318- 

A5 

3C 

LDA 

031A- 

E9 

08 

SBC 

031C- 

85 

40 

STA 

031E- 

A5 

3D 

LDA 

0320- 

E9 

00 

SBC 

0322- 

85 

41 

STA 

0324- 

A9 

IF 

LDA 

0326- 

85 

24 

STA 

0328- 

B1 

40 

LDA 

032A- 

29 

7F 

AND 

032C- 

C9 

20 

CMP 

032E- 

B0 

02 

BCS 

0330- 

C9 

60 

CMP 

0334- 

90 

02 

BCC 

0336- 

E9 

20 

SBC 

0338- 

09 

80 

ORA 

033A- 

20 

ED FD 

JSR 

033D- 

C8 


INY 

033E- 

98 


TYA 

033F- 

29 

07 

AND 

0341- 

DO 

E5 

BNE 



#$07 

$0328 


Routine starts here 
first print address 

O 343 - 20 92 FD JSR $FD92 

0346- A9 AO LDA #$A0 

0348- 20 ED FD JSR $FDED 


then print hex digits 


034B- 

034D- 

0350- 

0353- 

0355- 


B1 

3C 


LDA 

($3C) 

20 

DA 

FD 

JSR 

$FDDA 

20 

BA 

FC 

JSR 

$FCBA 

?° 

60 

BB 


BCC 

RTS 

$0310 


I want to use the screen dump program 
that appeared in NIBBLE EXPRESS Vol. 1. 
The program is written for the Apple 
parallel printer, but I am trying to use 
it with a Silentype printer. What 
changes do I have to make? 

This program directly calls the printer 
driver software on the interface card. 
For the Apple parallel printer, the 
output routine starts at address $CX02, 
where X is the slot number. For the 
Silentype printer the output routine 
begins at address $CX07. The screen dump 
routine assumes that the printer is in 
slot 1 so you should change all 
references to address $C102 in the 
program to $C 1 07 - 

A different screen dump program by Tom 
Warrick was published in the June 1982 
issue of the WAP newsletter. This pro- 
gram eliminates the problem discussed 
above, and should work with most any 
printer. & 



STOCK MARKET AND 
STOCK OPTION PROGRAMS 

★ ★ ★Stock Market Utility Programs ★ ★ ★ 

Provides a complete data base management system for 
creating and modifying individual stock data files and a 
graphical evaluation of comparative stock performance. 

Five programs provide for entry and storage of stock data, 
data correction, autoscaling Hi-Res graphical display of 
performance, and building historical data files 
electronically from downloaded MicroQuote data. S80. 

★ ★ ★Electronic Stock Packaged ★ ★ 

A complete system including a password for accessing, 
retrieving, storing, and updating individual stock data files 
electronically using the Dow Jones Stock Quote Reporter. 
$120. (An extra option allows the use of the CCS clock card 
for automatic data access.) 

★ ★ ★Stock Option Analysis Program ★ ★ ★ 

Uses the Black-Scholes model to calculate the fair price of 
options and then calculates the expected profit or loss from 
any trade or spread involving up to three classes (e.g. 
horizontal spreads, vertical spreads, straddles, butterfly 
spread, etc.) of options on any one underlying stock for any 
time until the option expires. Supports user definable 
commission schedules, printer, hard copy graphics, and 
one or two disk drives. $250. Manual (alone) $25. 



H & H SCIENTIFIC 

Specializing in Investment Software 
1 3507 Pendleton Street 
Fort Washington, MD 20744 
Tel. (301) 292-3100 




APPLE ASSEMBLY LINE 

A newsletter dedicated to Apple assembly language 
programmers. Includes tutorial articles for beginners, 
advanced techniques you can use. handy utility pro- 
grams ready to type in and run. commented assembly 
listings of code found in DOS and the Apple ROMs, 
and much more! 

Published monthly since October. 1980. All back 
issues are still available at $1 .50 each. Quarterly disks 
are available to subscribers ($15 each) containing all 
the source code printed in three consecutive issues of 
Apple Assembly Line. 

Subscriptions to Apple Assembly Line are $15 per year 
in USA sent Third Class Mail; $18 per year sent First 
Class Mail in USA. Canada, and Mexico; $28 per year 
Air Mail to all other countries. We accept Visa. Master- 
Card. and American Express. 



S-C SOFTWARE CORPORATION 


2331 Gus Thomasson, Suite 125 


P.O. Box 280300 
Dallas, TX 75228 

(214) 324-2050 
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HLA Computers Success Story # 2 

It took HLA Computers to come up with the answer. We helped develop 
a program, using an Apple II personal computer, on a chicken farm. The 
owner wanted the Apple for more than mere record keeping. 

We love that sort of challenge. 

In an experimental program, we (and the versatile Apple II) opened the 
feed gates ... controlled the temperature and humidity... turned on and 
off the lights... plus other features that delighted the owner, drew rave 
reviews from the chickens and pleased us. 

That’s because we do more with computers than sales and service. We 
help in the design and application of programs that take you and your 
Apple personal computer a step beyond. 

If you happen to own a chicken farm (or a business or a professional 
office), HLA can help you . . . from scratch. 


Which came first: 

The chicken or the computer? 


tcippkz computer 


Authorized Dealer 




5700-J Sunnyside Avenue 
Beltsville, Maryland 20705 

(301) 345-1123 


COMPUTERS 


Apple National 
Account Dealer 
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THE PRIME PLOTTER m 


A comprehensive plotting package to meet the exacting needs for most business, technical, and 
scientific applications. 

The most powerful, versatile, flexible and complete plotting package ever developed for the 
Apple. With data management • statistical analysis • X-Y plotting • PIE Charts • Graphics • 
Slide Show/ replay • and much more. 

An OPEN-ENDED SYSTEM with built-in capabilities for CUSTOMIZATION and ADD-ON applications. 

PIE-CHARTS 


REMARKABLY POWERFUL 

In one session, using only THE PRIME PLOT- 
TER, you can: Create data files • Perform trend 
analysis and curve fit regressions • Plot the data, the 
fit or any function/mathematical subroutine • Save 
or print any screen at any time • Edit, add or delete 
units and then save the file for a demonstration • 
Over one hundred such replay files, each full of 
charts, can be stored on one disk • Then ... sit back 
and watch a step-by-step REPLAY of the whole 
show. 

HOW DOES IT WORK? 

The Prime Plotter is a modular system where 
each of its elements, such as the statistics, the plot- 
ting routines, and the character sets, can be replaced 
by another module. Thus, the base system can con- 
tinuously be extended and enhanced by add-on 
modules. 

EASE OF USE 

The Prime Plotter is a menu-driven system • 
Default parameters are displayed and can be 
changed before each step • Simple and easily 
learned terminology • Prompts with legal range for 
each input • Value or expression input • Ex- 
cellent error handling • Optional inverse cur- 
sor with top-bottom/left-right scrolling • And . . . 
you will discover much more. 

EXTENSIVE DOCUMENTATION 

A comprehensive manual with step-by-step tutorial 
and samples to ignite your creativity • A reference 
card • Demo files • Continuous support with 
a free subscription to our user newsletter and 
periodic new add-on Modules (see below) . 

FEATURES CHECK LIST 

General: No limit overlay and/or frames within 
one screen • Multi-screen display of both 
graphics and text • Over 100 colors. 

Data Management: Convert DIF files • Create 
data files • Edit, transform, add, or group data 
sets • Display, save, or print data and statistics. 

STATISTICS 

1. Curve Fit Regressions: Linear • Logarithmic • 
Exponential • Geometric • Inverse • Inverse Log 

• Spillman • Nth Order. 

2. Trend Analysis: Averaging • Moving Average 

• Smoothing • Growth Rate • Frequency & 
Cumulative histograms • Logistic curve. 

3. Distributions: Normal • Gamma • Chi-square 
tests and contingency table analysis. 

In Addition: User defined functions and sub- 
routines • Basic stats on any data set (sum, mean, 
S.D. etc.) • Customized Modules (see below). 

X-Y CHARTS 

Options: Data/fit • Log scale • HI-LO • Error 
bars • Axis of origin • User defined parameters 

for frame, axes, tic marks, grids, labels and graph types. 

Graph Types & Parameters: Over 20 symbols 
for scatter • Variable line thickness • Dotted line 

with variable increments • Variable step for area fill 
• Bars with variable width and 6 filling methods in 
15 steps • 3-D bars, or 3-D area fill in 4 direc- 
tions, variable width and filling step • Up to 15 

multiple bars on same tic mark • 10 different 
figures for unique figure charts. 


User Defined: PIE size (horizontal & vertical) • 
Location • PIE area used • 3-D PIE width • 
Unlimited number of pieces • Unlimited 
overlay of filling methods per piece *1-5 groups 
of pushed and/or exploded pieces. 

LABELING 

Two methods, shape table and a special 
character generator, provide: Uppercase • 
Lowercase • Small letter • Greek alphabet • Scien- 
tific symbols • Your own shapes or character set 
(compatible with the Apple Tool Kit ,m sets) • 
Placement in any screen location • 8 different 
directions • Multi-level super and sub script • 
Variable forward-backward spacing • 8 different 
rotations with shapes. 

Designs: Bold • Partially bold (horizontal or 
vertical) • Double size • Double bold • Inverse 
type and double width, or double height 
characters with the character generator • Additional 
20 unique typeset designs. 

Automatic label generation and placement with 
justification, prefix and suffix • Centering or 
plotting at predefined locations • Manual placement 
of several labels in one operation • Expression, 
keyboard cursor, or paddles/joystick inputs. 

GRAPHIC UTILITIES 

Inverse/invert, fill, or frame areas, even copy to 
another area • Free-draw of lines and shapes • 
Shape drawing. 

SLIDE SHOW/REPLAY 

Review your work at any time, stop at any moment 
and print the image or save it to disk. With this 
power, you can design unique multi-screen 
presentations of graphs, titles, data display and 
stats. Switch between the hi-res and the text 
screens, insert delays, plan an erase, or replot 
mode, and store the whole show in a fraction of the 
usually required space. You can also compress 
images for quick load (instead of redraw) and even 
chain files for an hour-long show, with hold, 
jump backward -forward, print, and save functions 
at your disposal. 

COMING SOON: 

• PLOTTER INTERFACE for the popular HP 
7470A and the STROBE 100 < m 

• BUSINESS RISK ANALYSIS module. 

• 3-D PLOTTING module. 

• MAPPING module. 

• THE PRIME TYPESETTER."" For the creation 
and management of shape tables, character sets, 
figures, typesetting designs, and much more. 

• Customized statistical modules can be 
ordered for a nominal fee. 

Requires: Apple II plus (48K) with a language card or 16K RAM card in 
slot 0 • DOS 3.3 • At least one disk drive • A printer • A graphic 
printer interface card, like the Grappler ,m or Pkaso, is recommended. 

See a demonstration at your local computer store or 
send for a demo disk, $15.00, refundable with 
purchase. 

Introductory Price: Only $239.95 

At your dealer, or directly from: 

PRIMESOFT Corp. P.O. Box 40, Cabin John 
MD. 20818 Phone: (301) 229-4229. Personal 
check, Visa, or MasterCard accepted. 


Apple, and Apple Tool Kit are trademarks of Apple Computer. Inc. Grappler is a trademark of Orange Micro Inc. Pkaso is a trademark of Interactive 
Structures. Inc HP 7470A is a product of Hewlett-Packard. STROBE 100 is a product of Strobe. Inc 
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5 iGnme.5 news 


by Do n n Hof f rn o n 


SIGAMES is the Washington Apple Pi special 
interest group concerned with two popular 
micro-applications: games and graphics. We 
meet every month at 10:30 AM. during and 
following the regular WAP meeting in Build- 
ing C, Lecture Room D of USUHS. All are 
welcome. The agenda is flexible; the meet- 
ing usually begins with a discussion ses- 
sion where attendees trade tips and field 
queries. This is followed by the main 
presentation (if there is one) after which 
newly released games are reviewed. At some 
point during every meeting, we play several 
minutes of a continuing adventure game, 
currently : Ulysses and the Golden Fleece. 


SEPTEMBER and OCTOBER MEETINGS 


Not much for paddle-play? Prefer to pro- 

§ ram? For the more intellectual among 

IGAMES membership Jim and John have 
created the Programming Competition. You 
are challenged to create (with the assis- 
tance of an animation package - e.g. The 
Arcade Machine, Graphics Magician) an 
arcade game. Endeavor to imbue your entry 
with all those qualities that are the 
quintessential via game : an original 
scenario, challenge (and the chance to win) 
at all levels, attractive graphics, etc. 
With just over one month to go, there are 
no submissions, so YOU could win by 
default. Submit unto SIGAMES!! The winner 
of the Programming Competition will receive 
an as-yet-unannounced graphics utility 
package. 


Once again, response to the last Appeal For 
Volunteers represented less than 1$ of 
SIGAMES* membership. If you would like to 
give a presentation/lecture or demonstrate 
our favorite game, or even if you just 
ave an idea for a presentation, call Jim 
Eatherly at (202) 2§2-6046. A SlG without 
participation is like an Apple without a 
power supply. 


*** t * I * P * S *** 

As usual, if you have any Tips. Tricks. 
Cheats or Techniques call Jim Eatherly at 
(202) 232-6046 or leave a message on the 

WAP Bulletin Board to WP1261. 

More Wizardy Character Enhancement Tech- 
niques 


At the October meeting, Danny Roth demon- 
strated Ming's Challenge, a new arcade game 
from Microfun - "Ming will send his Death 
Ships from space to get you ! If a Death 
Ship hits you. ..." 

CONTEST : SOME WINNERS and MORE TO COME 

The three month arcade-game tourny draws to 
a close this month. For those unfamiliar 
with the contest, the rules are as follows: 
each month, players in two age groups (8-12 
and 13-16) pit their gaming skill and cun- 
ning against that of their opponents in an 
unannounced game of quick-wits, speed, 
action, and dexterity. A player's score is 
a function of his raw-score and the level 
attained. The top scorer of each age group 
receives a copy of the game played. This 
month the final rounds will be played and 
the plenary laurels will be awarded - a 
copy of "the definitive adventure" Time 
Zone. The contest prizes have been most 

§ enerously donated by Columbia Computer 
ystems. 

September - Seafox : a Hi-res submarine 
chase game from Broderbund 

Age Group Winner 


8-12 Brian Wood 

13-16 Luke Wilbur 

October - Shuttle Intercept : terrain shoot 
' em up 

Age Group Winner 


8-12 Danny Roth 

13-16 David Kirkoff 


Doug Schafer, WAP member and SIGAMES en- 
thusiast, reports a real weird one for 
Wizardry players: Create a wimpy bishop, 
take him to the E)dge Of Town and attempt 
to Kdentify item #9 (remember - eight 
items is the limit). Your weakling Bishop 
will be credited with oodles of experience 
points. On his next visit to the Adven- 
turer's Inn, Whelp the Bishop can collect 
on his two hundred some experience levels. 


As promised, TIPS is back with info on how 
to shoplift from Boltac's Trading Post. 


* READ CAREFULLY THE SEPTEMBER SIGAMES * 

* REPORT BEFORE ATTEMPTING THESE METHODS * 

***»ft»ft»tt****ft***ftft*ft*»ftt»**»»«»»ft«ttft*««ft«» 


Do not pass this point without reviewing 
September's TIPS ! ! 

OK. You've read the September issue? 
Good. Now make sure that your character 
has nine letters in his/her name and eight 
items in his/her position and then boot up 
your sector editor. Locate the fifty- 
fourth (54th) byte after your character's 
name. You will notice a pattern : 01 00 XX 
(XX is a number between $00 and $64 which 
represents the item index). Every eight 
bytes following will contain three bytes in 
this format. This pattern occurs eight 
times : once for each of the character's 
eight items. To obtain any item, simply 
substitute it's number for one of the XX' s. 
Below is a table of the item indices. 
REMEMBER - these cheats are for the origi- 
nal Wizardy scenario only, and will NOT 
work for Knight of Diamonds. 

contd. 
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00 


10 


20 


40 


50 


0 ! broken itmj Latum, pot j staff +1 j leather +2 [evil shld +3 [silver gloves 
11. swrd 1. swrd +1 drag slayer chain +2 amu. Makanito evil swrd +3 
2 Is. swrd Is. swrd +1 [helm +1 [plate +2 [diadem Malor [evil s. swrd +3 


+2 scrl Badial 

helm +2 s. swrd -2 


3 anoi mace mace +1 [leather -1 shld +2 scrl Badial thief's dag 

4 anoi flail stf Mogref chain -1 evil helm +2 s. swrd -2 brst pit +3 

5 staff scrl Katino brstplt -1 dial pot dagger +2 lord's garb 

6 dagger [leather +1 shld -1 [ring Porfic [mace -2 Murasuma bl 

7 small shld[ch mail +1 jeweled amu [wereslayer [staff -2 Shuriken 

8 large shld plate +1 scrl Badios mage masher dagger speed ch pro fire 

9 robes shld +1 scrl Sopic poison mace cursed robes evil pit +3 


thief's daggar 
brst pit +3 
lord's garb 
Murasuma bid 
Shuriken 


a leather 
b ch mail 
c brst pit 
d plate 
e helm 
f[Dios pot 
-+ 


shld +1 scrl Sopic poison mace cursed robej 
brstplt +1 1. swrd +2 stf Montino leather -2 

scrl Badios s. swrd +1 bid cusinart chain -2 
scrl Halito mace +2 amu Manifo brst pit -2 
1. swrd -1 scrl Lomilw rod of flame shield -2 
s. swrd -1 scrl Dilto evil ch +2 cursed helm 
[mace -1 [copper glov[neut pit +2 [brst pit +2 
•+ + — + +- — 


j shld +3 
healing ring 
ring pro unaead 
deadly ring 
**Werdna's amu** 
[statu bear 


>60 statuette of a frog 
>63 gold key 


>61 bronze key 
>64 blue ribbon 


$62 silver key 


imt = item pot = potion ch = chain brst = breast pit = plate stf = staff 


Go Forth and Be Fruitful 




9174 Broken Oak Place 
Burke, VA 22015 
(703) 455-3432 


isk Waonnection 


WE HANDLE: / 

CDC $31.00 [ 

Wabash $27.00 \ 

Verbatim Data Life.. $27.00 \ 
Plastic Library Boxes x 

(with disk purchase). . . $2.50 
Nibbles Away II or 
Master Key ^ $69.50 

ALSO AVAILABLE: 

Flip-Files $22.00 

Plastic Pages (25) $12.50 

Disk Saver Kits $10.00 


>o 

WE CAN 
DELIVER TO 
WAP OR NOVAPPLE 
MEETINGS 
OR 

INCLUDE $2.50 
FOR UPS SHIPPING 


VIRGINIA RESIDENTS ADD 4% TAX 
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conned th£ dots 

b y \J a v i cl 1 1 1 o r Q q n s t c. i n and 
Charles K. fTlesztenyi 


(Note: This article was written by David 
Morganstein using notes and programs 
prepared by C.K. Mesztenyi. . .don’t blame 
C.K. for misstatements!!!) 

1. Introduction. 

One of the things that makes the Apple 
exciting is its graphics. Most of us are 
intrigued by kaliedoscopes of color, fast 
moving images, 3-D perspective and the 
other effects we have seen demonstrated. 
In this article we explore the capabilities 
of Apple graphics, some myths and reali- 
ties. 

In the second section we summarize features 
found in Applesoft: shape tables and plot- 
ting commands. We do not elaborate on 
these as there are many articles and books 
that allow the Apple owner to develop these 
methods with a little self-study. In the 
third section we explore features of Apple 
graphics which are not well documented. 
The most important points being that the 
Apple does not really have a 192 by 280 
pixel display as is commonly thought. We 
summarize how the Hi-res screen is mapped 
into the Apple memory. In the fourth 
section we discuss a BASIC routine written 
by Bob Bishop for demonstrating that the 
Apple can display 560 columns of pixels on 
a monochromatic monitor. In the fifth 
section, a machine language routine is 

& iven which can ’’connect the dots” on the 
i-res screen when supplied with two 
points. 

2. Plotting In Applesoft. 

There are two easy methods for drawing on 
the Hi-res screen. The first is plotting 
dots or connecting lines. This is accom- 
plished with the HPLOT command. To plot a 
dot at the point X, Y (where X is between 
0 and 279 and Y is between 0 and 191, writ- 
ten 0<X<279 and 0<Y< 191) use the command: 

HPLOT X,Y (first turn on the Hi-res 

display by the command HGR) 

The point 0,0 is in the upper left hand 
corner of the screen. X indicates the col- 
umn with X=279 being the right-most column. 
Y represents the row with 191 being the 
bottom-most. 

To draw a line from XI, Y1 to X2,Y2 use the 
command: 

HPLOT XI, Y1 TO X2,Y2 

The second well-documented method for draw- 
ing is with shapes. Having defined a 
"shape table" of one or more images, the 
individual images can be drawn with the 
command : 

DRAW n AT X,Y where n is the selected 
shape number. 


A useful variation for motion is the XDRAW 
command which compliments the color of the 
shape. Two successive XDRAWs will draw, 
then erase the shape. There are many low 
cost utility programs which assist in the 
design of shapes and in their storage as 
binary data files. 

Hand in hand with either the HPLOT, DRAW or 
XDRAW command is the HC0L0R command which 
selects the color of the line or shape. 
HCOLOR may be set equal to a number between 
0 and 7 to obtain either black, white, 
green, violet, blue or orange. 

3. What’s Really In There. 

From most descriptions of the Apple Hi-res 
display, you would conclude that the Apple 
can make 280 by 192 pixels of one of six 
colors (a pixel is a dot). This however is 
not the case. To see this try the follow- 
ing simple program provided by Bob Bishop 


10 HGR:HC0L0R=1 
20 HPLOT 0,0 TO 10,150 

Instead of a straight line you get five 
separate line segments. Another example is 
to fill the screen with a solid color by 
the following: 

10 HGR : INPUT’’SELECT COLOR NO. ”;C0 

20 HC0L0R=C0 

30 FOR Y=0 TO 191 

50 HPLOT 0,Y TO 279, Y 

60 NEXT Y 


Repeat the above for each of the color num- 
bers 0 to 7 and you will observe interest- 
ing differences. 

Let us begin with some background. There 
are two Hi-res screens which are memory 
mapped into either the area $2000 (decimal 
8192) to $3FFF or $4000 (16384 decimal) to 
$5FFF. By memory mapped we mean that by 
putting an eight bit byte into one of those 
areas, something will appear somewhere on 
the Hi-res display. 


For example, try the following experiment 
suggested by Bob Bishop (2). First, turn 
on the Hi-res display by typing HGR. Now 
POKE 8192,1. This places a bit pattern of 
00000001 into location $2000. If you are 
using a monochromatic display you will see 
a dot in the upper left hand corner. Now 
POKE 8192,2. This places a 00000010 in 
$2000. What happened on the screen? The 
dot moved. Try POKEing other powers of two 
such as 4 and 8. The dot keeps moving to 
the right. However, if you try POKEing a 
129 which has the following pattern, 
10000001, you will see the dot appear 
between the locations where you POKEed 1 
and 2. In fact, using the following set of 
values moves the dot in the smallest possi- 
ble steps: . „ 

contd. 
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Value to 
POKE 

Equivalent 
Bit Pattern 

1 

00000001 

129 

10000001 

2 

00000010 

130 

10000010 

4 

00000100 

132 

10000100 

8 

00001000 

136 

• 

• 

10001000 

• 

192 

• 

11006000 


From this you see that the location 8192, 
in the area of the upper left-hand corner 
can be used to position one of 14 dots by 
sequentially turning on each of the lower 
seven bits and having the high bit be off, 
then on. 

If you repeat this for location $2001 (8193 
decimal) through $2027 (8231 decimal) you 
will find that the sets of 14 points will 
move across the screen to the right hand 
edge. Thus, there are 14 times 40 or 560 
possible dots which can be turned on. 

Now if you had a color display on while you 
were doing the above, you would notice a 
repetitive pattern of colors: violet, blue, 

f reen, orange. That is, while you can have 
60 black or white dots on a monochromatic 
display, you can have only one fourth as 
many colored dots on a color display! It 
is this effect that causes the two short 
BASIC programs to give the odd results. 

If the above were not difficult enough to 
understand try repeating the experiment 
using location $202o (8232 decimal). While 
you expect this to be the second row of 
dots on the screen, it isn’t. The dot 
appears about a third of the way down the 
screen. To more easily understand this, 
examine page 21 of the Apple II Reference 
Manual. The diagram there explains why a 
BLOADed Hi-res screen fills simultaneously 
in three areas of the screen. The memory 
is filling continuously from $2000 to 
$3FFF; these locations do not map from top 
to bottom of the display screen. 

To draw a line connecting two points, we 
must put the correct data byte in the 
correct memory location. The value of the 
byte determines which of fourteen possible 

P ositions will appear, while the location 
n which the byte is stored determines 
which of 192 rows and which of forty sets 
of fourteen points in the selected row will 
be used. A BASIC algorithm for doing this 
was given in a 1979 article by Loy Spurlock 
(5). A comparison of several methods for 
determining the location and data byte 
required for a given coordinate can be 
found in the article by C.K. Mesztenyi (3). 
Clearly, the BASIC HPLOT command is easy to 
use in comparison to having to compute mem- 
ory locations and contents; it’s restric- 
tion is the funny appearance of what 
appears to be straightforward plotting 
requests as shown by the two examples ear- 
lier. 

It is worth mentioning that most other 
personal computers do not have the simple 
HPLOT alternative (nor the DRAW/XDRAW for 


shapes). In other machines, the programmer 
must resolve the same kinds of problems of 
what byte and what location. When pro- 

§ ramming in BASIC on these machines this is 
one with POKEs. Below we discuss two 

solutions to n connecting the dots” in 560 
point resolution. 

4. Super Hi-res in Basic 

One solution to obtaining Super Hi-res is 
to determine, in BASIC, which of the 560 
possible X positions you are plotting and 
then to select the color which can appear 
in that column. Such a solution was given 
in Bob Bishop’s article: 


100 FOR Y = 0 TO 159 
110 X* = 280 + Y / 8: Y% = Y 
120 GOSUB 1000: NEXT Y 
130 END 

1000 XX* = X* / 4: M* = X* - 4 * XX* 
1010 HC0L0R = 2*(M*=0) + 6«(M*=1) + 
1*(M*=2) + 5*(M*=3) 

1020 HPLOT X*/2, Y%: RETURN 


This program fragment determines which 
column is being plotted then, in SUB 1000, 
selects the proper color for display. Line 
1010 will set HCOLOR equal to 2, 6. 1, or 5 
depending on the value of M* (which must 
equal 0, 1, 2 or 3). A more elaborate ver- 
sion of this idea is given in the article 
by Dave Smith (4). 

5. Super Hi-res in Super Speed 


Since interpreted BASIC is notoriously slow 
when compared with machine language pro- 
grams, it would seem desirable to perform 
the "connect the dots" in native 6502 code. 
This is no simple task for a newcomer to 
the Apple. Below, we present a subroutine 
which can be called from another machine 
language program or from BASIC to do a 
Super Hi-res line draw. 

The routine below operates using a table 
look-up procedure to convert the X/Y point 
into the required data byte and memory 
location. This procedure operates through 
several tables which are entered with the 
row/column (X/Y) coordinate as an index to 
select the proper data byte and memory 
location (high and low bytes) for that 
coordinate. The table look-up method is 
much faster than recomputing the solution 
for each and every point to be plotted. An 
analysis of this and several other methods 
is provided in Mesztenyi (3). To use the 
method, the required tables must be pre- 
computed and stored in memory while the 
subroutine is in use. A BASIC program for 
preparing these tables is shown in Listing 
1 below. The program creates the required 
four tables: SCRNL, SCRNH (the Y address 
low and high bytes) and X7, X7R (the X-addr 
and bit position). In this example the 
tables are stored in the area of $6000 to 
$6400, just above the second Hi-res screen. 

The assembly language source code is given 
in Listing 2. The routine begins at $6400 
but could be reassembled to run almost any- 
where. The object code and required tables 
were kept together so that they could be 
BLOADed in one file. One feature of the 
program which could be criticized is that 
it is self-modifying. That is, the code 
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actually changes data bytes within itself. 
While this is generally considered to be a 
difficult to interpret and debug charac- 
teristic, it has one virtue in this prob- 
lem; it dramatically reduces the amount of 
code needed to solve the problem. However, 
it is not to be recommended for the 
beginning assembly language programmer. 

With a few moments of reflection, some of 
the problems to be dealt with emerge. The 
X and Y coordinates must be examined to 
determine if the line is to be plotted by 
incrementing (or decrementing) in the X or 
in the Y direction. For example, consider 
connecting the point 0,0 with the point 
3,50. By incrementing X from 0 to 3 we 
would have only 4 points to plot, one for 
each value of X. If we choose to increment 
in the Y direction we would have 51 points 
in four separate columns. Clearly the 
former procedure would be faster. (If the 
points had been supplied in the reverse 
order, 3.50 and 0,0. then we would be 
decrementing instead.) The conclusion is 
that the routine must compare the beginning 
and ending X and Y values and determine 
which drives the program and whether to 
increment or decrement. After determining 
this, the program could go to one of four 
sets of routines to perform the appropriate 
computations. The self-modifying code 
approach was chosen instead to redefine the 
program to perform the required operations. 
Lines 16. 24 and 26 are used to select the 
X direction and whether to increment or 
decrement. Lines 28, 36, and 38 do the 
same if Y is the choice. The selected 
values are placed in CHGLI and CHGOT. as 
instructions to be executed. Lines 44 and 
52 select the direction used to terminate 
the loop and store a compare (CPX or CPY) 
instruction in COMP & C0MP1. The actual 
plotting is done in lines 59 to 88, the 
area where code has been modified. The 
entire routine takes only $92 bytes in mem- 
ory (although the tables consume almost 4 
pages). 


A simple BASIC program which uses the rou- 
tine is shown in Listing 3. The program 
does not protect the tables and subroutine 
from being overwritten by BASIC variables; 
however, with such a small program and so 
few variables this is not likely to occur. 
The choice of Hi-res screen is POKEed into 
location $19 and the X1,Y1,X2, and Y2 point 
into locations $1C through $1F before call- 
ing the subroutine at $6400. The result... 
a super Hi-res line at super speeds. 

References: 


1. Apple II Reference Manual, Apple Com- 
puter Inc., 1979. 

2. Bishop. Bob, "Apple-II Hi-res Graphics: 
Resolving the Resolution Myth", Apple 
Orchard, Fall 1980. 

3. Mesztenyi, C.K. "Space/Time Analysis of 
Hires Alogrithms", Washington Apple Pi, 
July 1982. 

4. Smith, David E., "560 by 191 Plot Pro- 
gram", The Apple Shoppe, May /June 1981. 

5. Spurlock, Loy, "From the Forum", Apple- 
sauce, Oct. 1979. 


LISTING 1 


5 

6 

10 

15 

20 

l°o 

50 

l°0 

90 


REM 

REM 

REM 

REM 

REM 

REM 

REM 

REM 

REM 


LISTING 1 


HIRES TABLE GENERATION PROGRAM 
BY C.K. MESZTENYI 
X/7 STORED AT $6000-$6l17 
BIT(X/7) STORED AT $6200-6317 
SCRNL STORED AT $61l8-$6lD7 
SCRNH STORED AT $6318-$63D7 
TABLE BSAVED WITH A$6000,L$3D8 
LOMEM = 25600: REM $6400 
DIM IB(6) , , v 

100 IB(0) = 1: FOR I = 1 TO 6:IB(I) = 2 * 
IB(I - 1): NEXT I 

110 LI = 24576:L2 = 25088: REM $6000 & 
$6200 

120 FOR I = 0 TO 255: J = INT (I / 7):K = 

I - 7 * J: POKE LI , J: POKE L2,IB(K):L1 
= LI + 1 :L2 = L2 + 1 : NEXT I 
130 FOR I = 0 TO 23: J = INT ((I + 256) / 

7) :K = I + 256 - 7 f J: POKE L1.J: 

POKE L2,IB(K) :L1 = LI + 1:L2 = L2 + 1: 

, NEXT I „ _ . ~ _ 

140 LI = 24856:L2 = 25368: REM $6118 & 
$6318 

150 FOR I = 0 TO 2: FOR J = 0 TO 7: FOR K = 
0 TO 7 

160 N = 40 * I + 128 * J + 1024 * K:M = 

INT (N / 256) :N = N - 256 * M: POKE 
L1.N: POKE L2,M:L1 =L1+1:L2=L2+1 
170 NEXT K: NEXT J: NEXT I 
200 D$ = CHR$ (4): PRINT D$"BSAVE 
TABLES, A$6000,L$3D8" 

***ft»tf**tt*ft»ft*»«*ft*«*tt*tt*«fttttt«*ft**ftfttt*«» 

* 

* 

* 

* 

* 

» 

* 
ft 

»ftftft»««»*»ftftftftftftft»ftftftftft*»»ft»»««»«»«ftftftft« 

« 
ft 
ft 
ft 
» 

« 

* 
ft 
ft 
« 

« 
ft 
* 
ft 
ft 

ftftftftft«ftftft«ftftft*ftft«ftft»ftft«ftftftftftftftftftftftftftftftft* 


LISTING 2. 

FAST LINE DRAWING ROUTINE 
BY. C. MESZTENYI 11/10/82 

DRAWS FROM X1.Y1 TO X2,Y2 
WHERE 0 < XI & X2 < 256 


INPUT ON PAGE ZERO: 

PAGE = #$20 HIRES PAGE 1 
= #$40 HIRES PAGE 2 
BASL,BASH = TEMP CONSECUTIVE 
LOCATIONS 

DMIN = MIN (ABS (XI -X2) , ABS(Y1-Y2) ) 
DMAX = MAX { ABS (XI -X2 ) . ABS ( Y 1 - Y2 ) ) 
SAVE = TEMP STORAGE FOR Y-REG 
TABLES REQ'D: 

SCRNL = Y-ADDR LO BYTE 
SCRNH = Y-ADDR HI BYTE 
X7 = X-ADDR 

X7R = X-BIT POSITION 

REGISTERS DESTROYED BY ROUTINE 


ORG $6400 
ZERO PAGE DATA 
PAGE EQU $19 


BASL 

BASH 

XI 

Y1 

X2 

Y2 

DMIN 

DMAX 

SAVE 


EQU :» 1 A 
EQU !HB 
EQU me 
EQU JS1D 
EQU HIE 
EQU IF 
EQU !>FD 
EQU !SFE 
EQU $FF 


9 

10 
11 

* TABLE ADDRESSES: 

12 SCRNL EQU $6118 

SCRNH EQU 5*6318 

X7 EQU 5)6000 

15 X7R EQU $6200 

*ENTRY POINT 
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LINE 


PSX 

SVX 


PSY 

SVY 


16 

1 1 

19 

20 
21 
22 

1 1 

26 

ll 

29 

30 

31 

32 

ll 


ll 
ll 

41 

42 

4*1 

ll 
ll 

49 

50 

51 

52 
5 
5 

ll 
ll 

59 

60 
61 
62 

ft 

n 
u 

69 

70 

71 

72 

? 7? 

76 

ll 

CHGLI 
CHGLI INX 
80 
81 
82 
8 - 


LCY 


STLP 


LOOP 


LDX #$EA 
LDA XI 
SEC : 

SBC X2 ; 
BEQ SVX 
BCS PSX 
EOR #$FF 
ADC #01 
LDX #$E8 
BNE SVX 
LDX #$CA 
STA SAVE 
LDY #$EA 
LDA Y1 
SEC 

SBC Y2 
BEQ SVY 
BCS PSY 
EOR #SFF 
ADC #$01 
LDY #Jc8 
BNE SVY 
LDY #$88 
CMP SAVE 
BCS LCY 


COMP 

COMP1 

•COMP 

•COMP 


;LOAD OP-CODE FOR NOP 
;FORM XI -X2 

;OK IF ZERO 
; BRANCH IF POS 
;NEG. FORM 
; ABSOLUTE VALUE & 

;GET OP-CODE: INX 

;POS, OP-CODE IS DEX 
;SAVE X-DIFF 
;LOAD OP-CODE: NOP 
;FORM Y1-Y2 

;OK IF ZERO 
; BRANCH FOR POS 
;NEG, FORM ABSOLUTE 
; VALUE AND GET 
; OP-CODE: INY 


;POS. OP-CODE DEY 
; COMPARE ABS DIFF 
;FOR LOOP CONTROL 
; CONTROL ON X 
; STORE OP CODES 
; DMIN 

; OP-CODE :CPX (IMM) 


ll 


8? 


85 

86 MODOT 

87 CHGOT 
•gHGOT INY 

89 END 

90 


STX CHGLI 
STY CHGOT 
STA DMIN 
LDX #$E0 
STX COMP 
LDX X2 
STX COMP1 
LDA SAVE 
BCC STLP 
STX CHGOT ; 

STY CHGLI ; 

LDY #$C0 ; 

STY COMP 
LDY Y2 
STY COMP1 
LDY SAVE ; 

STY DMIN 
STA DMAX ; 

LDX XI ; 

LDY Y1 ; 

LDA #00 ; 

PHA : 

LDA SCRNL, i 
STA BASL ; 

LDA SCRNH.Y 
ORA PAGE 
STA BASH 
STY SAVE 
LDY X7,X 
LDA (BASL) 

ORA X7R.X , 

STA (BASL), 

LDY SAVE 

NOP ; LOOP INDEX COMPARISON 

NOP ; FOR TERMINATION 

CPX X2 (IMM) 

CPY Y2 (IMM) 

BEQ END ; RETURN IF SATISFIED 

NOP : OTHERWISE MODIFY 

OR DEX OR INY OR DEY 
PLA ; CHECK FOR THE OTHER 

CLC ; COORD CHANGE BY 

ADC DMIN ; COMPARING INCREMENTED 
BCS MODOT ; DMIN-SUM WITH DMAX 
CMP DMAX 
BCC LOOP 

SBC DMAX ; CHANGE NEEDED 
NOP : THUS INC OR DEC 

OR DEY OR INX OR DEX 
JMP LOOP ; AND REPEAT LOOP 
PLA ; REMOVE DMIN-SUM FROM 

STACK AND RETURN 
RTS ; DONE 


;DATA FOR DMAX 

; CONTROL ON Y 
; STORE OP-CODES 
: OP-CODE: CPY (IMM) 


DMIN 

STORE DMAX AND 
START LOOP WITH XI 
Y1 

DMIN-SUM=0 
SAVE DMIN-SUM 
:SET SCREEN BASE 
ADDR BY TABLE 
; LOOP-UP WITH 

Y-COORD 
SAVE Y-COORD 
GET X-COORD, LOC. 

Y : BY TABLE LOOK-UP 
OR-IT WITH BIT LOC. 

Y ; TOPLOT POINT 


LISTING 3 

5 REM LISTING 3. 

6 REM 

10 REM EXAMPLE USAGE OF THE FAST 

15 REM LINE DRAW ROUTINES 

80 D$ = CHR$ (4): PRINT D$"BLOAD 

FAST LINE DR AW . OB J+TABLES n 

90 HGR 

110 PAGE = 25:HI = 32 
120 POKE PAGE, HI 

130 INPUT "ENTER STARTING X,Y ":X1.Y1 
140 INPUT "ENTER ENDING X,Y ";X2,Y2 
155 BA = 28 

160 POKE BA,X1 : ' POKE BA + 1,Y1 
170 POKE BA + 2.X2: POKE BA + 3,Y2 
180 SUB = 6 * 4096 + 4 * 256: CALL SUB 
190 GOTO 130 c 



COPY DISKS BY 
PHONE WITH 
M ICROMQUER 

ft S I iiPLE -70-RUN PROGRflH TO TRANSFER FILES FROM DISKS OK ONE 
APPLE II TO DISKS OH HNOTFER FffPLE II OUER ft PHONE LIFE!!!! 

t TRANSFERS ANY TtPE OF FILE WITHOUT CQMJERSIQN FIRST 
t DATA COMPRESSION USED TO REDUCE TRANSMISSION TIME 
t WORKS WITH HftYtS KKRONODEM II APPLE II COMB CARDS 
t HQUES 6 TO 10 SECTORS PER MINUTE IN EITHER DIRECTION 
+ USABLE iJITH BOTH DOS 3 .2 fih® DOS 3.3 SYSTEMS 
t DOS 3.3 USERS HAY TfflN SFER BOTH 3.2 AND 3.3 FILES 
t EASY TUG-STEP 2KSTIHLI2HTIQH: MODEM SLOT AM) MODEM TYPE 
t m HARDWARE MODS OR CHANGES DEEDED FOR USE. 
t SOPHISTICATED ASSEMBLY LANGUAGE ROUTINES HGUE DATA FAST 
* HICROMOUER IS DESIGNED 30 YOU CftN EXCHANGE FILES WITH 
ANYONE UKG HAS AN APPLE II fiND A MODEM - EDEN IF THEY DO 
HOT HflUE THE HICROSOUER PROGRAM INITIALLY!! 
r ONLY HEEDS ft 43K APPLE II OR APPLE 11+ WITH A DISK II AND 
APPLESOFT IN ROM OR ft RAMCARD.. AH) ft MODEM. 

DflB SYSTEMS/ 9115 Rockefeller Lane/ Springfield/ Uft 22153 
MICROHDJJER AND MANUAL - 149.95 
SPECIAL INTRODUCTORY PRICE - $39.95 OJALID THRU FEB 1933) 

Hake check or noneg order pagable to DRB SYSTEMS. Allow 6-8 
weeks for deliver#. ! )ft residents/ please add 4*; sales tax. 
Manual aione $10.00. This amount will be dedicted t'rofl the 
purchase price of the program if gou decide to bug it later. 
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THt COST Of SCROLL I DG 

by Charles K . fTle s z t e n y i 


The scrolling routine is part of the 
Applet Monitor in the memory addresses 
$FC70-FCA7 and uses the vertical tabbing 
($FC22-FC2B) and base calculation ($FBC1- 
FBD8) subroutines. The routine moves the 
text lines in the text window up by one 
line and blanks out the last line. It is 
called from the C0UT1 routine of the 
Monitor when the current output cursor 
position is on the last row of the text 
window, and the character to be processed 
is a carriage return or line feed, or if 
the cursor is at the last character posi- 
tion of the last row. The cost of scroll- 
ing, i.e. the time needed to perform it, 
came up in the context of choosing a baud 
rate when the Apple is used as a terminal 
to a main frame computer. My objective was 
to selectively read a symbolic file stored 
on the main frame computer using only the 
TV screen of the Apple. Thus, after 
logging in with the Apple, operating as a 
dumb terminal and using the fastest baud 
rate possible, I wanted to output the file 
from the main frame to the Apple screen 
continuously until the part I wanted to 
read came up. At this point, a Ctrl-S 
(X-OFF) input from the keyboard could stop 
the output, giving me time to read the 
screen. A Ctrl-Q (X-ON) input from the 
keyboard could then allow me to continue 
with the output. This X-ON/ X-OFF protocol 
is available on many main frame computers. 
Using the Apple Super Serial card and 
direct wire connection to the main frame 
computer. I had available 300, 1200, 2400 
and 4800 baud rates. Occasionally, I lost 
some characters at the 1200 baud rate, but 
operating at the 2400 baud rate, I started 
to lose more and more characters. The lost 
characters were always after the start of 
new lines on the Apple screen, which indi- 
cated that the necessary scrolling for the 
new line needed too much time and meanwhile 
the incoming characters were lost. This 
experience motivated me to count the number 
of cycles needed to execute the scrolling 
routine and I came up with the following 
formula: 

T(V,H) = 16VH + 93.5V - 2H + 84 

where T is the number of cycles, V is the 
number of rows and H is the number of 
characters/row of the text window. Since 
the Apple has approximately a 1 -microsecond 
cycle time, T also gives the time in micro- 
seconds. Using the full screen (V=24, 
H=40), the time needed to perform scrolling 
is 


T(24,40) = 17608 microseconds 

Note, that this is only the time for 
scrolling; one should also consider the 
rest of the time needed to handle an 
incoming character, and to place it on the 
screen if needed. This time may depend on 
the ROM terminal program, but in any case 
it should not be more than two hundred 
cycles of which 67 cycles is spent in the 


rest of the C0UT1 routine to place a 

P rintable character on the screen. For 
ater reference, I denote this time by "c". 

The baud rate is measured as bits/sec. I 
have been using 10 bits/char (1 start bit, 
7 bit ASCII, T parity bit. 1 stop bit). 
Thus, the available time to process one 
incoming character, before the next comes 
in, is 


t (b) = 10/b sec. = 10 ,000 ,000/b 
microseconds 


where b is the baud rate. Placing the 
actual baud rates into the formula, we get 


t( 

t( 

t( 


300) = 33333 microsec. 
1200 )= 8333 " 
2400)= 4166 " 


Assume now, that an incoming character A1 
is picked up for processing as soon as it 
becomes available in the receive register 
of the ACIA, and it initiates the scrolling 
procedure. The processing of A1 takes T+c 
time. Meanwhile the next character A2 
arrives after t(b) time passes, and it is 
ready in the receive register. The third 
character A3 arrives, and overwrites A2 in 
the receive register when another t(b) time 
passes by whether or not A2 has been picked 
up. Tnus, T+c should be less then two 
times t(b), to prevent loss of the second 
character, and the characters arrive at 
full speed restricted only by the baud 
rate: 




T(V,H) + c < 2t(b) 

Looking at the actual numbers above assum- 
ing a full screen window, it is clear that 
there is no danger of losing characters at 
the 300 baud rate. At b=1200, the situa- 
tion is already different: 

T(24,40)+c = 17608+c 

2t( 1200) = 16666 

indicating the loss of the character fol- 
lowing the one causing a scroll. When I 
receive from the main frame computer a 
carriage return, line feed sequence, I lose 
the line feed character which should have 
been disregarded anyway since the carriage 
return automatically causes a scroll (line 
feed). On the other hand, the 41st char- 
acter of a longer line input can be lost 
since the 40th character causes a new line 
(scrolling), and the 42nd character can 
overwrite the 4 1st in the receive register. 

The above analysis assumes that the char- 
acter causing the scroll is picked up as 
soon as it arrives. If such a character is 
followed by another character causing 
another scroll (e.g. a carriage return), 
then this second character can not be 
picked up in time. To handle such cases, 
one should have T(V,H)+c<t(b) . 

contd. on pg 40 
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Starting in December the WAP will be 
organizing small discussion groups around 
the D.C. area. Below you will find a list 
of volunteers who will be holding sessions 
in December and January. These will be 
informal and last about 2 hours. If you 
would like to attend, call the host and 
register with them. Each host will limit 
the size according to their wishes and will 
let you know if there is room left for the 
tea of interest. Hopefully, there will be 


ample numbers of sessions to meet the 
interest. If not, we will seek additional 
volunteers. 

Session leaders may be needed if the host 
does not feel knowledgeable about the 
Apple. If you would like to help in 
organizing these sessions or would like to 
volunteer your home or help to be a session 
leader, contact David Morganstein. 


Apple Tea Schedule: 


Host Area 

Bob Hanson Frederick 

Walton Francis Chevy Chase 
Sue Roth McLean 

Scott Rullmann Bladensburg 
John Henry Georgetown 

Rollande Robert Annandale 
Dave Harvey Arlington 
Ginny Spevak Chevy Chase 
Robert Wood McLean 
Donna Campbell Rockville 
Joe Fuchs Adelphi 

Don Drinkwater Urbana 
H. Phelps Greenbelt 

Doug Richard Fairfax 
Robert Boyle Carlisle Pa. 
John Baker Alexandria 

A1 Weiner Wheaton 

Dick Sanderson Rockville 
B&D Acton Gaithersburg 

Judy Fite Fairfax 

E&M Kelty Bethesda 

David Margulies Bethesda 


Phone Date/Time 


662-6697 Jan 
245-0291 Dec 
356-9025 Jan 
779-5714 Dec 
625-7633 Dec 
256-4121 Jan 
527-2704 Dec 
362-3687 Dec 
893-9591 Dec 
424-5069 
434-6756 Dec 
831-9234 Dec 
345-0355 Dec 
323-1027 Dec 
717-245-0030 
354-9715 Dec 
946-2585 Dec 
983-9419 Dec 
428-3605 Dec 
691-1082 Dec 
229-5639 Dec 
530-9190 Dec 


13/7:30 

10/6-10 

13 / 8-10 

11/7:30 

2/7:30 

21/9:30 

11 / 8-10 

8 / 8-10 

9 / 8-10 


9/7: 

9/6: 


:30 
9/6:30 
15/8-10 
2/8-10 


1 m, 

19/3-5 

12/1-3 

4/3-5 

12/7:30 

15/6-10 


Date/Time Leader 
Needed 


Feb 

10/7:30 

Y 

Jan 

14/6-10 

N 

Feb 

12/10-12 

Y 

Jan 

15/7:30 

N 

Jan 

6/7:30 

Y 



Y 

Jan 

15/8-10 


Jan 

19/8-10 

Y 

Jan 

6/8-10 


Jan 

15/7:30 

N 



N 

Jan 

14/8-10 

Y 

Jan 

6/8-10 

Y 



Y 

Jan 

11/8-10 

N 

Jan 

Jan 

16/3- c- 

23/1-3T 

N 

Jan 

29/3-5 

Y 

Jan 

Jan 

9/7:30 

26/6-10 

Y 

Y 





in Apple W 
programming. 
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usiho6w ^ 

ASSEMBLY 

LANGUAGE 


Programming 6502 Assembly Language is no 
longer frightening or a monster problem. Because 
Randy Hyde has written the book that’s easy to 
understand, easy to follow. It turns assembly 
language into the ‘friendly language’. For anyone. 
For the average Apple H owner and the newest 
beginner. 

Let Mr. Hyde get you started immediately, with 
string and math operations. See how to convert 
BASIC programs so they run up to 100 times 
faster! Discover Sweet-16, the ‘hidden’ 16-bit 
pseudo computer inside your Apple. Enjoy using 
your Apple to the maximum by following the step- 
by-step, practical examples. . .which turn you into 
a programmer in the blink of a chapter. 

I thanks to Mr. Hyde 

bly ^ $19.95 per easy-reading copy at computer 
stores everywhere, or from: 

DATAMOST 

19273 Kenya St. 

, Northridge, CA 91326 

(213) 366-7160 


'Apple II is a trademark of Apple Computer. Inc. 


VISA/MASTERCH ARGE accepted. 
SI. 00 shippinglhandling charge. 
(California residents add 6% tax) 
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us i no th£ mom tor 

CTRL-Y mT£RFRC£ 


b ,y UU i M. i o m 5 chu l t h e. i s 


The Apple II monitor provides a number of 
commands useful to the assembly language 
programmer. One of the most versatile is 
the CTRL-Y command. CTRL-Y is roughly 
equivalent to the "&" command in Applesoft 
in that it allows you to add your own 
command functions to the monitor. This 
month’s column gives you some tips about 
how to take advantage of the CTRL-Y feature 
and describes some of the monitor routines 
used for monitor command processing. 

The CTRL-Y command is described briefly on 
page 57 of the Apple II Reference Manual. 
This description is thoroughly confusing 
and gives no idea of how to pass data to 
your command. A slightly more detailed 
explanation occurs on page 86 of "Apple II 
Monitors Peeled", a publication of Apple 
which contains a lot of useful information 
about the monitor. But neither of these 
sources tells you enough to exploit the 
full parameter passing capability of the 
monitor. 

How does the CTRL-Y command work? When the 
monitor scans a CTRL-Y, it does a JMP to 
location $03F8 which is the location of a 
jump instruction to your own command rou- 
tine. When you load your CTRL-Y routine, 
you simply store the proper JMP instruction 
at $3F8 and you are ready to go. When vour 
routine is called, it can access the values 
of parameters which precede the CTRL-Y on 
the command line. It is this ability to 
access parameters which gives the CTRL-Y 
its versatility. 

Getting at Arguments 

Your CTRL-Y routine will need some or all 
of the following symbolic definitions to 
interact with the monitor: 


YSAVE to save the scan index between calls 
to GETNUM. The sequence: 

LDY YSAVE ;GET SCAN 
LDA IN-1 ,Y ;GET LAST CHAR 

can be used to retrieve the most recently 
scanned character. You can check for the 
end of the input line by checking the next 
character for a CR: 

LDY YSAVE ;GET SCAN 
LDA IN.Y ;GET CHAR 
CMP #$8d ;IS IT CR? 

BEQ LINEND 

When commands have numeric, parameters, 
these are stored in the two-byte locations 
A1 to A5. The location MODE is used to 
save certain parameter punctuation marks, 
and this controls how parameters are 
assigned to the parameter locations. 

The method the monitor uses to pass command 
arguments is best shown by examples. In 
the examples which follow, the character 
"y " will denote a CTRL-Y and "Cr" will 
denote a RETURN. All these examples work 
the same way whether the y is followed by 
cr or a blank and another command. 

No parameters: 

*ycr 

A2 will contain zero with other parameter 
locations unchanged. On entry to your 
routine the x-reg contains 0 and the a-reg 
contains zero. The y-reg always contains 
zero, no matter how many parameters are 
involved. 

One parameter: 


MODE 

EQU 

YSAVE 

EQU 

AIL 

EQU 

A1H 

EQU 

A2L 

EQU 

A2H 

EQU 

A3L 

EQU 

A3H 

EQU 

A4L 

EQU 

A4H 

EQU 

A5L 

EQU 

A5H 

EQU 

IN 

EQU 

GETNUM 

EQU 


$31 

U34 

i;3C 

s;3D 

s >3E 

S3F 

MO 

: > 4 1 

$42 

$43 

i>44 

s>45 

U200 

$FFA7 


MODE FLAG 
SCAN INDEX 
A1 LOW 
A1 HIGH 
A2 LOW 
A2 HIGH 
A3 LOW 
A3 HIGH 
A 4 LOW 
A4 HIGH 
A5 LOW 
A5 HIGH 
INPUT BUFFER 
READ HEX NUM 


*800ycr 

A1, A2, and A3 all contain $800. A4 and A5 
are unchanged. On entry to your routine 
the x-reg contains a 1 , indicating that the 
y was preceded by a number. The a-reg 
contains 0. Note that you can always_test 
for a numeric parameter before the y by 
coding: 


DEX 

BMI NONUM 


Two parameters: 


IN is the 256 byte buffer which holds the 
most recent line entered from the keyboard. 
The monitor uses GETNUM to retrieve hex 
numbers and command codes from the input 
buffer. GETNUM uses the y-reg to scan the 
input line, so the sequence: 


LDA IN, Y 
INY 


;GET CHAR 
; POINT TO NEXT 


*800.900ycr 

A1 and A3 contain $800 and A2 contains 
$900. On entry to your routine the x-reg 
contains 1. The a-reg now contains $AE, 
the negative ASCII code for the "." between 
the two numbers. You could also use three 
other characters, "+", "-", and ":" as 
separators: 


reads a character from the line and points 

to the next. The monitor uses the location contd. 
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*800+900ycr 

*800-900ycr 

«800:900ycr 


($AB in a-reg) 
( i >AD in a-reg) 
($BA in a-reg) 


Omitting the first number: 


*.900ycr 

A2 contains $900. A1 and A3 are unchanged. 
The a-reg contains $AE and the x-reg 
contains T. 


Omitting the second number: 

*800 .ycr 

This is not so useful. A1 and A3 contain 
$800 while A2 contains zero. The a-reg 
contains $AE and the x-reg contains 0. 

Three parameters: 

*B00<800.900ycr 

A 4 and A5 now contain $B00. Everything 
else is like the two parameter case with A1 
and A3 containing $800 and A2 containing 
$900. The a-reg contains $AE and the x-reg 
contains 1. 


The two and three parameter formats are 
ideal for commands which search, move, or 
compare memory. The $800 parameter in 
these examples would be the beginning of a 
range of memory to process, ana $900 would 
be the end of tne range. The $BOO would be 
a destination address. The monitor has two 
routines which make it easy to code such 
routines: 

NXTA4 EQU $FCBA 

NXTA1 EQU $FCB4 


Each time you call NXTA1 it adds one to the 
contents of A1L,H and compares it to the 

number in A2L,H and returns. If A1 is less 

than or equal to A2, the carry flag is 

clear. If A1 is greater than A2, the carry 
flag is set. NXTA4 adds one to the number 
in A4L,H and then executes NXTA1. Using 
NXTA4 a memory move instruction can be 

coded in just five instructions: 

CTLY LDA (AIL) , Y ;GET BYTE 
STA (A4L),Y ; STORE IT 
JSR NXTA4 ;STEP ONE 
BCC CTLY ;A1 <= A2 
RTS 


Notice that the three input parameters are 
still available. If the command had been 
n A00<800.900y n , the second copy of $800 
would be in A3 and the second copy of !>A00 
would be in A5. The original value of $900 
would be in A2. You could copy A3 into A1 
and A5 into A4 and loop through the same 
range of memory again. 


More About GETNUM 


If you want to know how all this works, you 
have to dig a little deeper into the inner 
workings of GETNUM and some other monitor 
routines. GETNUM does most of the work, 
reading hex numbers and command codes from 
the input buffer. Each time it is called, 
GETNUM tries to read a hex number stopping 
when it encounters the first non-hex 
character. It starts reading the buffer at 


IN,Y and updates the y-reg as it reads. It 
returns one or three copies of the number 
it finds there depending on the contents of 
MODE, and returns as a command code a 
scrambled version of the first non-hex 
character it finds. The routine calling 
GETNUM is responsible for setting up MODE 
and saving the y-reg between calls. 

When GETNUM is called it (1) sets the x-reg 
to zero, (2) stores zero in A2L and A2H. 
and (3) reads the character at IN,Y. It 
then tries to convert the character into a 
value from 0 to 15. If it fails the 
scrambled character is left in the a-reg 
and GETNUM returns with the updated scan 
index in the y-reg and 0 in the x-reg. If 
the conversion succeeds, GETNUM performs a 
four bit double shift from the a-reg into 
A2L and A2L into A2H. The process of 
shifting always leaves a 1 in the x-reg. 
GETNUM then proceeds to read another input 
character. The process repeats until the 
conversion fails. GETNUM then looks at the 
contents of MODE. If MODE is zero, GETNUM 
copies the two-byte number in A2 into A1 
and A3. When GETNUM returns, the scrambled 
command code is in the a-reg and the y-reg 
points to the next character in the input 
buffer. If there was no number before the 
command code, the x-reg contains 0 and A2 
contains 0. On the other hand, if there 
was a hex number before the command code 
then the x-reg contains 1 and the number is 
in A2. If MODE is zero then the same 
number is in A1 and A3. I know that seems 
complicated, but it makes more sense when 
you see more of how the monitor works. 

The monitor treats every non-hex character 
as a potential command. After each call to 
GETNUM the monitor saves the y-reg in YSAVE 
and looks up the scrambled command charac- 
ter in a table of legal scrambled commands. 
If it matches a table entry, the monitor 
gets the corresponding address and branches 
to the command routine. Just before it 
makes the call, the monitor executes the 
following instructions: 


LDA MODE 
LDY #0 
STY MODE 


This sets MODE to zero, sets the y-reg to 
zero, and passes the old value of MODE in 
the a-reg. Note that the x-reg still 
contains 1 or 0 depending on whether or not 
the command was preceded by a hex number. 


The method behind this madness starts to 
appear when you look at the command table. 
It turns out that the characters 
,, + M , and are commands, or more accu- 

rately they are alternate codes for a 
routine called SETMODE. SETMODE is a very 
simple, routine; it retrieves the command 
code (unscrambled) from the command line, 
stores it into MODE, and returns. Now 
consider what happens when you enter the 
command: 


*800.900ycr 

The first call to GETNUM reads $800 into A2 
and copies it into A1 and A3 (MODE is 
always set to 0 at the beginning of a new 
line). The scrambled is returned as a 
command code. The monitor looks it up in 

contd. 
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the table and calls SETMODE. SETMODE gets 
the from the command line and puts it 
into MODE. The monitor calls GETNUM again 
and it reads $900 into A2. But now the " . " 
is in MODE so A1 and A3 are left .alone. 
The monitor looks up the scrambled y and 
calls the routine USR. USR is a single 
instruction: 

JMP $3F8 


if $3F8 contains a JMP to your routine, 

‘ ~“0 in A2 


and 
the is 


So __ 

you are on your way with $80 
$900 in A1 and A3. If you care, 
in the a-reg. 

The final piece of the picture is the "<" 
command. The "< n processing routine is 
called LT. LT copies the contents of A2 
into A4 and A5 and returns. So consider 
the command: 


*800<1 1 .Fycr 
This is what happens: 


1. GETNUM reads $800 into A1, A2, A3 

2. LT copies $800 into A4 and A5 

3. GETNUM reads $11 into A1, A2, A3 

4. SETMODE stores into MODE 

5. GETNUM reads $F into A2 

6. USR jumps to your routine 


and you have the following inputs: 

A1 - $11 
A2 - $F 


- Jill 

- J>800 


COST OF SCROLLING contd. from pg 36 

One could rewrite, and improve the scroll- 
ing subroutine of the Monitor by removing 
its general text window feature, assuming 
the full screen at all times. It would 
need approximately a 12^ improvement to 
make the 1200 baud rate safe to use assum- 
ing a full screen. A better solution would 
be to buffer the input for each incoming 
line ending with the carriage return char- 
acter. Force the sending main frame com- 
puter to wait after each line output. Dur- 
ing this waiting time, the buffered line 
can be placed on the screen, necessary 
scrolling performed, etc. 

A simpler solution is to use tabbing. Hor- 
izontal tabbing decreases H, the number of 
characters per line; vertical tabbing 
decreases V, the number of lines. Decreas- 
ing H by one would reduce T by 282 cycles, 
while decreasing V by one would reduce T by 
733.5 cycles. Allowing enough time for c 
(processing the character), we should 
cnoose V = 20, which gives: 

T(20,40) = 14674 microseconds 

allowing almost 2000 cycles for c. 

A good modem with 1200 baud rate costs 
around $1000. The increased transmission 
speed may be required, especially to per- 
form file transfers; on the other hand, it 
may cause timing problems as indicated 
above. & 


A5 - $800 

This might be a command to call RWTS and 
read track $11 sector $F into a buffer at 
$800. After all, why spend $25 or more for 
a disk edit program if you can write your 
own? (Ed. Note: Are those hex dollars?; 

You can pass still mo£e parameters by hav- 
ing them follow the y on the input line^ 
You can retrieve the character after the y 
by coding: 

LDY YSAVE 
LDA IN , Y 
INY 

STY YSAVE _ 

By testing this one letter you can select 
one of a whole set of user functions. You 
can even call GETNUM to read numeric param- 
eters. Just remember to leave YSAVE point- I, 
ing to the character following your last 
parameter, and the monitor will never know 
the difference. 

The possibilities for using the CTRL-Y 
interface are limited only by your 
imagination. 

So... happy assembling! 

Note: The topic for this column was 

suggested by David Morganstein. If you 
have a problem or application you would 
like me to write about, let me know at a 
meeting or call the hot line number. 
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RPPL£PLOT/€PSOn 

by Bob 5ch m i ci t 




For a couple of years now, I've been using 
the Appleplot program for business trend 
plots, and I found that I had luckily 
chosen the Grappler board for my Epson 
printer. With this combination, I could 
plot my charts to the screen (HIRES) and 
following a 'reset', could do a HGR dump to 
the printer. Neat, but I then had to rerun 
the program to do the setups for the next 
screen print-out. All that work with a 
resident program which already has a 
'print' routine - but to only two printers 
(which seem to be in the minority). Oh, to 
use the routine with an Epson. 


2) delete lines noted above; 

3) modify lines 334, 940, and 950 as listed 
in List 2; 

4) add lines 1100 thru 1135 (List 1); 

5) return pointers, and 

6) save program. 

This routine should work for any printer - 
ust use your printer-unique commands in 
ines starting with 1100. 


Due to the efforts of an Apple compatriot, 
an addition (List 1) was POfCEd to the end 
of the program with suitable EOP pointer 
modifications to use the EPSON printer 
because regular programming changes did not 
work. For the same reasons, I made a 
change to line 354 to print to screen the 
file name just pulled from the disk memory 
when adding more data points. When doing 
plots of many fields, it is easy to forget 


which file one is working 


I located the 


memory location of line 354 (by searching 
through a lot of machine language dump) ana 
swapping machine bytes in the appropriate 
locations to add the "FI$" (file name) 
without changing the exact length of the 
line. Doing it this way, I didn't have to 
relocate lines, HIRES screen, or anything. 
Ugh, what a job - but to add insult-to- 
injury, the program 'burped' and cried 
''out-of-memory". With 131 sectors of 
APPLEPLOT as the basic program, there just 
wasn't enough room for even these few 
lines. 


LIST 1 

1100 GG$ = "EPSON" : GOSUB 958 : G0SUB 
1105 : RETURN 

1105 HOME : INVERSE : PRINT "EPS ON MX-80": 
NORMAL : VTAB 5: PRINT "PARAMETERS:" : 
VTAB 10 : 1$ = "" 

1110 PRINT TAB(5) "DOUBLE-SIZED?":: GET X$: 
PRINT X$ : IF X$ = "Y" THEN 1$ = 1$ + 
"DR" : GOTO 1120 

1115 PRINT TAB (5) "ROTATED?"; : GET X$ : 
PRINT X$ : IF X$ = "Y» THEN 1$ = 1$ + 
"R " 

1120 PRINT TAB (5) "EMPHASIZED?";: GET X$ : 
PRINT X$ : IF X$ = "Y" THEN 1$ = 1$ + 
«>E" 

1125 PRINT TAB (5) "INVERSE?"; : GET X$ : 
PRINT X$ : IF X$ = "Y" THEN 1$ = 1$ + 

it j it 


And so, I went to our prolific expounder of 
profound solutions to our many questions (Q 
& A) and asked how to delete those lines 
used for the other printer routines. With 
the usual insight we have come to love from 
our own "Q & A" column, came the July '82 
issue, pgs. 10 and 11 (reproduced at the 
end of this article for your convenience), 
for the 'how-to' changes possible without 
the need to 'POKE' in the data. This is 
accomplished by resetting the 'start-of- 
program' pointer to ignore the first part 
of the program. This is done by setting 
locations $67 and $68 to the address of the 
first program line after the HIRES screen. 
That address is $4971. From the monitor, 
enter '67:71 49 <cr>* and do all the modi- 
fications (in APPLESOFT) as usual. When 
finished, reset $67 and $68 to $801. the 
normal start (in monitor => '67:01 08 
<cr>'). Worked great and I was able to 
reduce the program length from 33000 to 
31904 bytes by removing 31 lines (941 thru 
948, 952 thru 957, and lines 1004 thru 
1052) even with the Epson routine included. 
And finally, I slightly 'modified lines 940 
and 950 to clean up the screen routine. To 
make all these changes: 

1 ) follow the Q & A routine to change 
pointers; 


1130 PRINT CHR$ (4) "PR#1" : PRINT CHR$ (9) 
"G"I$ : PRINT CHR$ (10) CHR$ (10) 

1135 PRINT CHR$ (4) "PR#0" : RETURN 

LIST 2 

334 HOME : VTAB 2 : HTAB 8 : PRINT 
"DATA ENTRY" : VTAB 5 : PRINT 
"ENTERING DATA FOR:"; : PRINT FI$ : 
PRINT TAB (2) ; "PLOT 1 (»;N1;« PTS)" : 
PRINT TAB(7);"0R" : PRINT TAB(2);"PL0T 
2 (":N2;" PTS) SELECT (1 OR 2)? ": : 
INPUT " " ; SE$ : IF SE$ = QZ$ THEN 276 

940 HOME : PRINT TAB(2) ; "PRINT THE GRAPH 
ON THE EPSON PRINTER" 

950 GET T$ : PRINT T$ : GOTO 1100 

The following is reprinted from the July 
1982 Q & A: 

Q. How do I remove the program segments 
from Appleplot relating to the Silentype 
and Qume printers? I have a mod to 
Appleplot which adds the option of an 
EPSON printer (utilizing a Grappler 
board). Upon entering data into the 
rogram for printing, I have experienced 
out of memory) #77 ERROR when I collect 
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over 2 sectors of data. It seems that 
the added program uses too much memory. 
Any suggestions? 


A. From your enclosure documenting the 
changes you made, you indicate that you 
changed the program by using the Monitor 
to directly modify the program. This 
appears to be necessary because part of 
the program disappears if it is modified 
normally by typing in new lines. In 
fact part of the program can easily be 
modified. The problem is that the pro- 
gram is split to fit around hi-res page 
T. For Apgleplot the dividing line num- 
ber is 232. Lines 232 and below cannot 
be modified without re-splitting the 
program. Anything above this line num- 
ber can be modified by performing a 
simple trick. Applesoft does not like 
to modify programs that have been 
’’split". The way around this is to 
reset the start of program pointer to 
ignore the first part of the program. 
This is done by finding the start of the 
first program line after the split which 
for Appleplot is $4971 and setting loca- 
tions $67 and $68 to this address. For 
example from the Monitor do ’67:71 49’. 
Now you can modify the last half of the 
program all you want and when finished 
reset $67 and $68 to $801 the normal 
start (*67:01 08*), save the program 
and you’re all done. I made the modi- 
fications you included and found that 
only 506 free bytes of memory remain 
before entering any data. Space for the 
data values themselves has already been 
allocated via DIM statements but as you 
define the graph parameters other vari- 
ables are assigned that apparently 
exceed the available storage. The solu- 
tion is to remove the unneeded program 
lines dealing with the other printers 
and to rewrite your modification to 
conserve space by combining several 
statements on one line and using sub- 
routines for common code. 


Figure 1 - Result 


TIDBITS 

p Rom news ic 

b ,y Bern i e Bens o n'**' 

If the following paragraphs seem familiar, 
it is because they appeared in last 
February’s Pi. The WAP has gained over a 
thousand members since then and I think 
this information can be helpful to them as 
well. This brings up a growing problem 
concerning new computer owners. The 
problem involves how to get the ever grow- 
ing amount of published information about 
the APPLE into the hands of new owners. 

Three quick reminders this month. 

(1) Never plug or unplug anything into the 
peripheral boards, expansion slots, or the 
main circuit board of the APPLE while it is 
turned on; not even the game paddles, un- 
less the device specifically says you can. 

Doing so can permanently damage chips on 
the cards and the main board as well as the 
power supply. 

(2) The air is very dry this time of year 
in Washington and static electricity is 
common. This can be very harmful to your 
APPLE. To avoid any problems, simply 
ground yourself by touching the large case 
of the power supply before touching any 
other component in the computer. The power 
should be turned off but the power cord 
should NOT be unplugged. The computer is 
grounded through the power cord. Make sure 
the outlet that the cord is plugged into is 
properly grounded. Care must also be taken 
when carrying peripheral cards, disk, etc. 
across a carpeted floor. 

(3) Looking for an inexpensive stand for 
your Epson MX-80 or similar size printer? 

Try a five dollar parsons table. The 
printer sits on it nicely and a box of 8.5 
by 11 fanfold paper fits under it. If you 
want the printer on a larger desk top but 
have no way to feed paper to it, set it on 
just the top of the parsons table. Cut one 
side panel out of the top and about 2 
inches of paper will feed nicely from under 
the raised printer. & 
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by L eon H . R QOS 


Well, this is my first attempt at writing 
to such a knowledgeable audience. If the 
Editor is willing, I hope to present a 
monthly column on the "Apple and Business". 
Within this very broad area, I would expect 
that the column would cover several aspects 
of the Apple* s interface with business. 
These would include: 

1. Systems (or structures) surrounding the 
Apple* s use. 

2. Training programs and their conceptuali- 
zation. 

3. Basic systems maintenance. 

4. Sources for special forms, material, 
etc. (the type of "stuff" not available 
from Apple dealers). 

5. Unique or special applications of vari- 
ous software. 

6. Information from Business SIGs in our 
own and other other Apple groups. 

7. Exchange of ideas from business users. 

8. Anything else that you are willing to 
contribute to this column. I would hope 
that many of these columns would 
actually be written by you, the business 
reader. 

I operate two Apple's currently, and am in 
the process of acquiring another for my 
lace of business (a Community Mental 
ealth Center) - I am continually surprised 
at the extensive need for microprocessors 
in all types of business. I believe that 
there are five basic types of programs that 
ALL businesses should nave. These are: 

1. A word processor program (we have four, 
but have finally settled on Letter 
Perfect, for its ease in interfacing 
with its companion Data Base Program, 
and any text file program) . 

2. A data base system (again, we have four, 
but have settled finally on Data 
Perfect, for the reason given above). 

3. A checkbook program (many are available 
- we use "the Home Account"). 

4. An electronic spreadsheet (we use the 
ever popular VisiCalc). 

5. And even more important than any of 
these, a nibble copy program for making 
backup copies. (We have three that we 
keep, Locksmith, Nibbles Away II, and 
Master Key +.) 

Which leads me to the concept that I wish 
to cover for this article. The operating 
principle that we use is "BACK IT UP", ana 
its two corollaries, "SAVE BEFORE...." 
(save before printing, save before turning 


the machine off, save before taking a 

break, SAVE BEFORE ANYTHING), and 

"DON'T DELETE". Disks are cheap, labor 
isn't, and that temporary data you just 
deleted will undoubtedly be needed three 
days later! 

Many businesses (and ours is one of them) 
use essentially inexperienced operators on 
the Apple. After all, if you had to hire 
programmers to run the programs, the advan- 
tages of an Apple would disappear. Not to 
mention what the cost would do to your 
profit (the BOTTOM LINE, of course!). So 
in line with our basic principal, we will 
not purchase a program that we cannot make 
a "USE COPY" for our people. So any 
program must be copyable bv one of the Copy 
programs available (COPYA or a nibble 
copier). We then store the original in a 
special Master File, where it cannot be 
touched until needed again. 

To make it more difficult for our inexper- 
ienced operators to goof, we also use a 
special color coding of disks. I would 
like to share it with you, as I have found 
that by doing this, our operators have a 
much easier time of it. 

DISKETTE COLOR CODES 

RED Program Diskettes 

1st Line - Name of Program 
2nd Line - PROGRAM DISKETTE 
rd Line - Leave Blank 
th & 5th Line - USE COPY (write 
VERY large) 

BLUE Data Diskettes 

1st Line - DATA DISK #n 
2nd Line - Name of Program 
3rd Line - Name of Special Use 
4th Line - Date Diskette Put in 
Use 

5th Line - ORIGINAL (Write in 
caps, and circle) 

(Special Note, when diskette is 
full, write the word FULL on the 
BLUE label.) 

WHITE with Duplicate Data Diskette 

BLACK border (SAME AS ABOVE, 5TH LINE 
SAYS DUPLICATE!!) 

GREEN System Master 

(We have several different Sys- 
tem Masters, each to be booted 
with special functions, such as 
V-C Expand, a Move DOS, the 
standard DOS, etc. 

For the Color labels, we use the Avery 1" x 
3" removable labels, in Day Glow colors. 
The Day Glow label is placed at the top, 
left side of the diskette, and the regular 
lined label (provided with the blank disk- 
ettes by the manufacturer) is placed on the 
top, right side of the diskette. The 
original' label from the manufacturer is 
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removed prior to attaching our two labels. 
Since inaugurating this system, we have had 
no mis loading of data disks for programs 
(and the consequent stopping of all work 
while they find me, because "...it doesn't 
work - what broke!”, or trying to save data 
onto a full program disk, and the sometimes 
consequent aborting of the program, and 
losing all the data that they have just 
entered) ! 

Although a minor aspect of using an Apple 
in business, we have found that the color 
coding above has saved us a substantial 
amount of time and hassle. 

WAP BUSINESS SIG REPORT 

The meeting October 30th was attended by 18 
people, and chaired by our Chairman, John 
New. 40$ of those attending were inter- 
ested in stock/bond applications/uses, and 
about 60$ in a variety of general business 
uses. John presented an overview of Apple 
memory, and some understanding of how that 
would apply to programs or firmware we 
might purchase. 

John also presented an interesting report 
on business applications which make use of 
microprocessors. The percentages reflect 
the percent of owners using them for each 
application. They were as follows: In- 
ventory control - 43$; Invoice - 36$; 
Accounts Payable - 36$: Accounts Receivable 
- 36$; Sales Tool - 33$; Analysis - 33$; 
Recommend - 33$ (I was not clear on what 
that meant); Projections - 27$; Customer 
Information - 20$. Also of interest to me 
was that in terms of the survey. 77$ of the 
respondents HAD a micro, and 23$ were con- 
sidering purchasing one. This must have 
skewed the results, for it seems to me that 
those considering a micro would depend on 
advertising to give them potential uses, 
while those that owned one would base their 
responses on actual trials of what worked! 
Of further interest was that the TRS-80 
reflected 57$ of the respondents, and the 
Apple 35$. This would also have skewed the 
results, for the TRS-80 does not support 
independent programmers; thus those appli- 
cations would be mostly based on Tandy’s 
decision of what "ought" to be available, 
whereas the Apple people will try anything, 
and if it sells, it continues to be avail- 
able! 

The November program will include discus- 
sions by all attendees and general sharing 
of their experiences and applications. 
Ralph Hallen and I will lead the discus- 
sions. There will be a special workshop by 
John New and Dr. Ernest Forman at John's 
house within the next 6-8 weeks on use and 
applications of a program called "The 
Acountant". 

There will be no December meeting (because 
of the SWAP scheduled at that time). The 
January meting will include both "experts" 
to talk about tax uses, and breaks, and an 
open question/sharing portion including the 
other members. It promises to be par- 
ticularly interesting, and I am sure John 
New will have something "HOT" for us! 

Well, that's it for this month. Please let 
me know your reaction to this type of col- 


umn, and send in material to be included 
now, while you think of it. How about a 
list of the DOs and DON'Ts, ALWAYS, and 
NEVERs you use in your organization? Or 
maybe the things you've learned (usually 
the HARD way) about working with the Apple, 
or programs, or your staff? Whatever it 
is, if it relates to an Apple and your 
business, send it in. And while I am on 
the subject of your input, how about a 
joint effort? You provide a list, and a 
one or two line (at most) description of 
the various applications that you have for 
VisiCalc, and I will compile them, and list 
them in a future column. Such a list may 
trigger potential new uses for you! Thanks 
for "listening" today! & 



ffl ci r k D - P a n k. i n 


The response to the questionnaire in the 
October newsletter was underwhelming, a 
total of 7, but that is enough encourage- 
ment to get started. (Of course, responses 
are still welcome. See page 50 of the 
October WAP.) 

There was near unanimous interest in having 
us publish a list of member complaints 
about hardware and software, a list of 
local dealers and what special considera- 
tions (if any) WAP members will receive, 
and a list of local hardware repair facili- 
ties and which peripherals they service. 
Less interest was expressed in having us 
mediate customer/dealer disputes ana in 
providing guidance on formally filing 
complaints with government agencies or 
courts. We will follow these guidelines by 
focusing on compiling the dealer and repair 
facilities (both dealers and others) lists. 
Those having both complaints about and 
praise for hardware and software will have 
a greater effect if they write a short 
review or letter to the editor for publica- 
tion. The consumer advocate is interested 
in hearing both complaints and praise, but 
is hesitant to publish "good buy" or "bad 
buy" lists based on a limited number of 
possibly very subjective reports. 

Now an appeal for help. The sooner the 
data can be collected, the sooner the lists 
can be published. If you are willing to 
make phone calls or help in any other way 
(what do you think the consumer advocate 
should be doing?), please call me at home 
(703) 370-9219. You can call during the 
day if you don't mind talking to my answer- 
ing machine. This effort requires more 
than one person to be successful, so I will 
share any credit for what gets done. To 
that end, I hereby convey my thanks to 
Conrad Fleck who did most of the work writ- 
ing the questionnaire and to Fred Schulz 
who provided several valuable ideas and 
insights into hardware problems. $ 
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RPPLG WORD PROCESS 

3 U R V€ V by Jqc k. UUci r n <z r 





At the October meeting, I circulated a 
survey form to collect information for a 
forthcoming primer article for the Apple Pi 
Beginners Guide. You may not be a begin- 
ner, but may need a word processor if you 
are working your way up in the world, pre- 
paring your homework, or just dashing off a 
note to tell Mom what just happened to 
Garfield, your cat. 

Thanks goes out to 115 WAPers who partici- 
pated in this survey. Some own more than 
one word processing package. 


After printing a file the program must be 
rebooted to edit correctly — a serious flaw 
(we have Videx enhancer + 80 col board.) 
O.K. Good first word processor. For new- 
comers; user must learn the arbitrary 
instructions which aren't user friendly due 
to limited capability of Apple keyboard. 
Not too good for extensive tabular work; 
very good otherwise. No tabbing. Weak on 
editing options for deletion (lines etc.); 
80 column board makes this an excellent 
WP...A must! How about two windows into a 
delete buffer? 


Here are the results to help you in making 
that crucial decision... to write or not to 
write, and with what! The decision is as 
complex as visiting a pen store and trying 
to decide with which of their 15,000 pens 
to write your first novel. 

The survey form listed 41 word processing 
and related software e.g., spelling and 
merging programs, that Apple had listed in 
one of their ads. Interestingly, WAP 
respondents listed only 21 (some not on the 
Apple list). The survey results are 
tallied by the information given on the 
form. I chose the evaluation categories 
used in INFOWORLD evaluations. 

Let the buyer beware! The August and Sep- 
tember issues of PEELINGS ana the August 
PERSONAL COMPUTING contain extensive word 
processing reviews. These are good, like 
the consumer magazines that rate by fea- 
tures and include chatty remarks by the 
reviewer. They give you an idea of all the 
bells and whistles available and which ones 
have what. However, like most articles 
they reflect limited opinions and are not 
always correct (what do you want from a 
person that reviews 50 or more WP pro- 
grams ! ) 

This survey reflects WAP users baring their 
happiness and woes! The comments are unex- 
purgated from the forms. 

Survey Results 

(30) APPLE WRITER II (INCL.5-1 , 1VER) 
REPLIES (P)00R (F)AIR (G)OOD (E)XCEL 


PERFORMANCE 
DOCUMENTATION 1 
EASE OF USE 1 

ERROR HANDLING 
SUPPORT 2 


15 

15 

12 

12 

10 


8 

14 

6 

3 


( 1) LEXICOM-WP TO OTHER FORMATS 

REPLY (P)00R (F)AIR (G)00D (E)XCEL 


PERFORMANCE 1 

DOCUMENTATION 1 

EASE OF USE 1 

ERROR HANDLING 1 

SUPPORT 1 


COMMENTS: Flaw is that its data disks are 
DOS 3.2. copy protected software. I use it 
to convert AW files to other formats for 
other WP. With DOS 3.3 I have to Muffin 
and Niffum files... a pain! Documentation 
from Micro-spare is typed sheets. 


( 3) EASY WRITER WORD PROCESSOR 
REPLIES (P)00R (F)AIR (G)00D (E)XCEL 


PERFORMANCE 
DOCUMENTATION 
EASE OF USE 
ERROR HANDLING 
SUPPORT 


2 1 
1 2 
1 1 
1 1 1 
1 1 


COMMENTS: Expect new version mid-83 per 
mfg. telecon. Had trouble with the u/1 
case display. . .did not use enough to figure 
it out yet. 


( 1) F0RMULEX BUS. FORM DESIGN 
REPLY (P)00R (F)AIR (G)00D (E)XCEL 


PERFORMANCE 1 

DOCUMENTATION 1 

EASE OF USE 1 

ERROR HANDLING 1 

SUPPORT 1 


COMMENTS: I only use this because its in 
Apple Pascal... it could rank amongst the 
best if Apple or someone would support. 


( 2) GOODSPELL 

REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 


COMMENTS: Easy to learn. Not copy pro- 
tected. WPL not well explained for begin- 
ning user, i.e. Help!. Lacks many features 
but several available packages (AW Ex- 
tended, Graftrix) provide them. AWE pro- 
vides screen formatting and printing. Best 
part is that is unprotected and we have 
modified it. Especially flexible & easy 
for novice to use quickly. I can't get it 
to scroll smoothly. Not well adapted to 
writing text of any length or complexity. 


PERFORMANCE 
DOCUMENTATION 
EASE OF USE 
ERROR HANDLING 
SUPPORT 


1 

2 


1 

1 


COMMENTS: The only spelling checker I have 
on Apple DOS. Lacks convenience and power: 
doesnH compare to CP/M world. Wish it 
could be modified to work with text files. 


contd. 
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( 4) LETTER PERFECT 

REPLIES (P)00R (F)AIR 

(G)00D 

(E)XCEL 

PERFORMANCE 

1 

3 

DOCUMENTATION 

3 

1 

EASE OF USE 


4 

ERROR HANDLING 

2 

1 

SUPPORT 

1 

2 


COMMENTS: Easy to use. Doesn’t try to do 
everything. Works well with Epson/Neo I, 
Ver. 5.01. Built-in Ctrl codes for Diablo 
are wrong. Very versatile - 40 or 80 
column; excellent data base merge with any 
Apple text file. Stores files either as 
text or binary - your choice. My spouse 
found this much easier to use than Super- 
scribe II. 


( 1) MAGIC WAND WORD PROCESSOR 
REPLY (P)00R (F)AIR (G)00D (E)XCEL 


PERFORMANCE 1 

DOCUMENTATION 1 

EASE OF USE 1 

ERROR HANDLING 1 

SUPPORT 1 


COMMENTS: I am a new user and repeatedly 
received wrong info from the store. My 
rating reflects this. 


( 4) MAGIC WINDOW WORD PROCESSOR 
REPLIES (P)00R (F)AIR (G)00D (E)XCEL 


PERFORMANCE 
DOCUMENTATION 
EASE OF USE 
ERROR HANDLING 
SUPPORT 


2 2 
2 1 
1 1 2 
2 1 1 
1 1 


COMMENTS: Easy to use, extremely reliable 
(New Version) Will support 160 columns. 
Would like to see an 80 column version. 
Menu driven allows kids to do homework 
project easily. Didn’t like it at all. 
Ctrl codes match functions generally. 


( 2) MAIL MERGE ENHANCEMENT WORDSTAR 
REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 


PERFORMANCE 
DOCUMENTATION 
EASE OF USE 
ERROR HANDLING 
SUPPORT 


2 

2 

1 1 
2 

2 


COMMENTS: A must for form mailing. Very 
easy to personalize ’’boilerplate" text. 
Powerful. . .has many uses... wish it dis- 
played file format (like Format I) and had 


logic capabilities 
mailer) . 

(like 

Supertext’s 

( 2) PASCAL EDITOR 




REPLIES (P)OOR (F)AIR (G)OOD 

(E)XCEL 

PERFORMANCE 


1 

1 

DOCUMENTATION 


1 

1 

EASE OF USE 


1 

1 

ERROR HANDLING 


1 

1 

SUPPORT 



1 

COMMENTS: Can see on 

screen 

what 

document 


contains. Easy to enter. Requires a text 
formatter for pagination, etc. 


(2) PIE WRITER 

REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 

PERFORMANCE 1 l"~ 

DOCUMENTATION 1 1 

EASE OF USE 1 1 

ERROR HANDLING 1 1 

SUPPORT 1 1 

COMMENTS: I ordered Pie Writer & got Pie! 
Pie would not save a file after editing. 
Best one yet. Complicated to learn. Most 
flexible and versatile of all. For 80 col. 
Written by a programmer. 


( 1) SANDY WORD PROCESSOR 

REPLY (P)OOR (F)AIR (G)OOD (E)XCEL 


PERFORMANCE 1 

DOCUMENTATION 1 

EASE OF USE 1 

ERROR HANDLING 1 

SUPPORT 1 


COMMENTS: Uses standard text files. Has bug 
concerning underlining. 


(20) SCREENWRITER x 

REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 


PERFORMANCE 

DOCUMENTATION 4 
EASE OF USE 3 
ERROR HANDLING 4 
SUPPORT 2 


COMMENTS: Original Superscribe written in 
Sanscrit: On-Line’s 2 updates: 1st free, 
2nd $10, made it workable, then super. I 
received Screenwritter II as a replacement 
for Superscribe II. I like using the pro- 
gram very much. Had many questions con- 
cerning interfacing with my NEC 8023 
Printer. Apple Writer is easier to learn 
but SW has much greater capability. Un- 
usable by a fast typist (>60wpm). Only 
difficulty is scrolling backwards in edit 
mode. To do a hardware mod is required. 
Needs 80 column interface. Documentation 
for Superscribe has, for some features, 
better explanation. Essential for anyone 
using footnotes. Cursor movement awkward 
as Is shift/ctrl+key. On-Line’s policy of 
trading up to new versions is great. A few 
annoying bugs, but limited to highly spe- 
cific applications. e.g. spooling, Centronic 
driver. The 70 chrs display is unsatis- 
factory. Index could be better. This is 
one of the two or three best WPs available. 
For u/1 case and 70 columns it’s a best 
buy. 


( 2) SECRETARY, THE WORD PROCESSOR 
REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 


PERFORMANCE 1 1 

DOCUMENTATION 1 1 

EASE OF USE 1 1 

ERROR HANDLING 2 

SUPPORT 


COMMENTS: Good features but slow menus. 40 
or 80 column. Has built in simple data base 
& electronic mail capability. 


8 

14 

14 

11 

5 


12 

2 

3 


contd. 
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( 3) SENSIBLE SPELLER 

REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 

PERFORMANCE 1 2~~" 

DOCUMENTATION 1 2 

EASE OF USE 1 2 

ERROR HANDLING 1 1 1 

SUPPORT 2 


COMMENTS: Most flexible Spelling program 
Has a 80,000 word dictionary. A must if 
you kan't spel. 

( 1) SPELLSTAR 

REPLY (P)OOR (F)AIR (G)OOD (E)XCEL 

PERFORMANCE V~ 

DOCUMENTATION 1 

EASE OF USE 1 

ERROR HANDLING 1 

SUPPORT 1 

COMMENTS: Easy to run and correct problems 
in text. 

03) superscribe””^ 

REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 

PERFORMANCE ~~1 4 

DOCUMENTATION 2362 
EASE OF USE 2 6 3 2 

ERROR HANDLING 5 2 

SUPPORT 1 5 2 

COMMENTS: Too many commands! Some problems 
with 80 col. board. Like the appearance of 
u/1 chip better than graphic generated 
characters. Has index, superscript fea- 
tures. Page formmating has been a problem 
for me. Having to reboot editor after 
run-off & vice versa is irritating... 
otherwise very good. Super program. Best 
buy for the price. Sequences are rigid; 
not easy to change mind. 

( 2) SUPER-TEXT WORD PROCESSOR 

REPLIES (P)OOR (F)AIR (G)OOD (E)XCEL 

PERFORMANCE 1 l’“ 

DOCUMENTATION 1 1 

EASE OF USE 1 1 

ERROR HANDLING 2 

SUPPORT 2 

COMMENTS: Control codes bear no relation- 
ship to the functions they perform. 

(10) SUPERTEXT II 

REPLIES (P)00R (F)AIR (G)OOD (E)XCEL 


PERFORMANCE 
DOCUMENTATION 
EASE OF USE 
ERROR HANDLING 
SUPPORT 1 


COMMENTS: Very good program for the price. 
No Index. Has math mode, split screen. 
Documentation has no index, uses printer 
Ctrl. Lines over 40 col. go to next line. 
Has 80 columns but margins are not dis- 


( 2) WORDHANDLER 

REPLIES (P)00R (F)AIR (G)00D (E)XCEL 

performance I 1 

DOCUMENTATION 1 1 

EASE OF USE 2 

ERROR HANDLING 1 1 

SUPPORT 2 

COMMENTS: Generates u/1 case. Can print two 
page layups for booklets, picking & placing 
the matching pages properly. 

(17) WORDiTAR 

REPLIES (P)00R (F)AIR (G)00D (E)XCEL 

PERFORMANCE 7 ! 5 ~~ 

DOCUMENTATION 368 

EASE OF USE 12 5 

ERROR HANDLING 10 7 

SUPPORT 27 2 

COMMENTS: The best of six WP programs used. 
A very friendly program. Extremely easy to 
use — on screen menus — Mailmerge and Spell- 
star available. No occasion to seek help 
in application. Good as a first draft text 
editor, but editing a file is more trouble- 
some due to 64K Apple memory. WS goes down 
when too many changes are made. One day of 
hard work=competence. Spellstar hard to 
figure out at first. Using 2 Ctrl charac- 
ter commands and being able to print only 
after saved to disk is a pain. None of the 
others come even close. If WS doesn't have 
it you don’t need it... except footnotes! 
Excellent, selectable levels of prompts. 
Easy to learn by a novice. Super program- 
tough to install, easy to use. Meets our 
needs, but poor font selection. No 
graphics. 


ES-CAPE 


two years for extensive writing. 


Extended S-C 
Applesoft Program Editor 

A programmer's tool to speed up and simplify the de- 
velopment of Applesoft BASIC programs. ES-CAPE 
provides a split-screen editing window: you can LIST a 
portion of your program in the upper window and inde- 
pendently edit other lines in the lower window. Editing 
functions include character insertion and deletion, line 
truncation, and simple entry of lower case and control 
characters. 

Other major features: global search and replace. DOS 
command menu, automatic line numbering, list control, 
user-definable keyboard macros, variable display, and 
much more! ES-CAPE is user-friendly: most com- 
mands are a single keystroke. There is no need to 
memorize; three menus remind you of every command 
and macro. 

The price of $60 includes both regular and RAM card 
versions of ES-CAPE on a copyable diskette, the 22 
page comprehensive manual and a quick reference 
card. We accept Visa. MasterCard, and American Ex- 
press. 

S-C SOFTWARE CORPORATION 
2331 Gus Thomasson, Suite 125 n 
P.O. Box 280300 
Dallas, TX 75228 

(214)324-2050 ( TT? i 
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EDSIG Calendar 


Tuesday, December 14 at 7:30 p.m. 


Language Arts for Elementary Schools. 

Mary Brown and Karen Berlin, two EDSIG 
members, will present their new product, 
"Kidbits Word Fair", a language arts pack- 
age for use in pre-school through fourth 
grade. 

Tuesday, January 11 at 7:30 p.m. 


Video tapes presentation made at the Horace 
Mann Learning Center. Topics include com- 
puter literacy, MECC, and Microsift. 

All EDSIG meetings are held in Lecture Room 
A, Building A. at the Uniformed Services 
University of the Health Sciences, on the 
campus of the Naval Medical Center, 4301 
Jones Bridge Road, Bethesda, MD. 

Meeting Reports 


Tuesday, November 9 

Learning Disabilities and the Apple. 

Special education has always been a partic- 
ular concern of EDSIG, so we were very 
pleased when Carolyn Adler of Electronic 
Learning Facilitators (ELF) introduced 
Nancy and Yehoash Dworkin from the Center 
for Unique Learning. They work with chil- 
dren and teenagers who have learning prob- 
lems. or, as they prefer to put it. "those 
people who are learning in a way that is 
unexpected". 

For them, a computer offers a way to 
explore the logic of the learner. 

Their work is almost exclusively focused on 
BASIC. This provoked a spirited exchange 
with the LOGO fans - "Computer efficiency 
is not the issue. You have a structured 
mind - if I want to communicate with you, I 
would use LOGO; my pupils do not have a 
structured mind - BASIC is better for them. 
As one of the pupils said, 'I like BASIC. 
It speaks English the way I do.* " 

The center has ten computers ("If we had a 
hundred, it wouldn't be enough"), a mix of 
Apples, TRS-80s and Altairs. They do not 
see the computers as primarily teaching 
tools. "The computer is essentially a 
lousy teacher, but it is a magnificent 
student." The computer is part of a team - 
"a teacher and a number of students, one of 
whom is a computer". Some of their early 
successes were based on programs in which 
the student "teaches" the computer. ANIMAL 
was an early example of this, and led two 
students, who originally could not read or 
write, to go off the the library to do 
research projects on their own initiative. 


Programs that simply used the computer as a 
"page turner" have not proved useful, but 
muen use has been made of "Interactive Fic- 
tion" programs. Recently, "arcade" style 
programs have been used successfully. 

The computer is not an instant panacea - 
"What makes us think that a child with any 
difficulty in reading a book will do any 
better reading a computer?", but, properly 
organized, the computer can be used to 
produce powerful learning situations. 

The presentation concluded with a fascinat- 
ing account of teams of learning disabled 
students working together to produce teach- 
ing programs, some of which will soon be on 
the market. 

Forthcoming Events - Dianne Lorenz 


WINTER COMPUTER CLASSES 

ELF - Classes in "Getting Comfortable with 
Computers" and BASIC for adults. . .classes 
for parents and children together in BASIC 
and LOGO, and classes for children in 
beginning and advanced BASIC and LOGO. 
Call 493-9696. 

Hands-On Science - Introduction to com- 
puters and computing for children 4 years 
old and up, beginning December 6 and con- 
tinuing for 8 weeks. Several, locations in 
the Silver Spring area. Call 649-6921. 

Learning Works (657-4488) and Open Univers- 
ity (966-9606) offer BASIC programming for 
adults and special classes in computer 
applications. 

Adult education - Montgomery County - 
Beginning and Advanced levels of BASIC 
programming for adults. Evening classes at 
several area high schools. Call 942-8304. 

The Computer Workshop - Two new classes for 
December: dBase II and Advanced BASIC for 
children. Special workshops: How to Start 
a Word Processing Business, How to Choose a 
Printer, and Apple Writer II. Call 
468-045$. 

WINTER WORKSHOPS and CONFERENCES 

MECC '82 Educational Computing Conferences, 
Minneapolis, MN. Practical sessions di- 
rected at educators involved in promoting 
the use of computers in schools. Pre- ana 
post-conference training sessions in devel- 
oping courseware, programming micros, and 
in-service planning. Call (612) 376-1131. 
November 9 - December 3. 

Microcomputers in Education Workshop - TERC 
workshop covering the use of micros in 
various educational applications, graphics, 
and programming languages. Call (617) 
547-3890 for workshops in our area. 

NCCE Conference - Oregon State University - 
A three day conference 'Linking Computers 
with Learning'. Call (503; 376-6111. 
February 17-19. & 
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by George K i n o l 


The Telecomm SIG meeting was held after the 
main meeting on October 30. Reports were 
made on members* evaluations of two low- 
cost modems (a brief comparison of the two 
is given below). At the main meeting of 
WAP, approximately 30 to 40 persons ex- 
pressed interest in having the club store 
carry low-cost modems. Consequently, the 
SIG chairman will work with Rich Wasser- 
strom to make the necessary arrangements. 


its handset, so you must have a new phone 
with modular connectors on the handset 
cord. It has a standard DB-25 (RS-232) 
connector on it, so it should be used with 
a serial interface board. However, we have 
found that it can be run from the game port 
using the BIZCOMP or similar software (MFJ 
Enterprises sells *'via gameport '* software). 
An RS-232 to game port cable can be easily 
made using parts from Radio Shack. 


It was also reported that with appropriate 
software, most RS-232 modems can be 
operated via the game port, in lieu of a 
serial interface. BIZCOMP and MFJ sell 
such software for their own modems. The 
necessary connections are simple: 


Now the focus is on 


Game Port pins 3, 8, 15 to RS-232 (modem) 
pins 3 i 7, 2, respectively. 



This method has some limitations in soft- 
ware flexibility, but is an inexpensive 
means for Apple owners to communicate with 
bulletin boards, etc. 

A report was also given on another low-cost 
means of interfacing: the QUEST serial 
board, $51.25 in kit form. This interface 
does work, but because it has no firmware 
is also limited in flexibility. 

George Kinal has completed research on 
telephone line lightning protectors, and is 
ordering a number of them for interested 
members. (See article in November 1982 
WAP; the protectors are easy to install and 
cost only about $7.) 

Future SIG meeting topics that are planned 
include: communications software package 
evaluation and comparison; amateur radio 
and Baudot teletypwriter applications. 

TWO INEXPENSIVE MODEMS - A COMPARISON 

We have evaluated two low-cost 300 baud 
modems (each are about $75 to $100). 

BIZCOMP: 

This modem is ORIGINATE ONLY (cannot talk 
to another originate modem). It is powered 
from the phone line. It plugs into a 
modular telephone wall jack. It has a 
simple 5-pin connector on it. You can buy 
or make a cable to connect from this to 
either the Apple game port or to a serial 
interface (RS-232). BIZCOMP sells with the 
game port cable software to run via game 
port. This software is somewhat rudiment- 
ary, but is adequate for bulletin board 
access, etc. After you outgrow this soft- 
ware, you can add a serial i/f and more 
powerful software. 

ANCHOR SIGNALMAN: 

This modem is battery powered (9 volt). It 
can operate either originate or answer 
mode. It plugs between the phone set and 


MICROCOMPUTER SUPPLIES 
MINI FLOPPIES 


.Single side/ single density 
SYNCCM "Ectype" 22.00 

2M SCOTCH 25.99 


single side/double density 
VERBATIM "DataLife" 

KffiE "Accu trade" 

34 SCOTCH 
SYNCCM "Ectype" 


28.50 

28.50 

31.50 

28.50 


CARTRIDGE RIBBONS 

New film tor Ricoh Printer each 4.75 
Recycled Ricoh film ribbons each 2.95 
DIABLO Hytype II black cloth doz. 44.75 
DIABLO High capacity film doz. 46.50 
EPSON MX/0/80 each 9.50 
IDS "Paper Tiger" each 10.75 
NEC Spiiwriter film or cloth doz. 66.00 
NEC compatible film ribbons doz. 48.00 
QIME Black film or cloth doz. 33.95 


CONTINUOUS FORM PAPER 


size 
7T/2 x II 
9 1/2 x 11 
9 1/2 x 11 
14 7/8 x 11 
14 7/8 x 11 


st k no. wt. ’ sheets price 
69KFP 15# 350CT 27.25 
691QPP(20) 20# 2700 25.95 
691CHSPP 18# 3000 26.40 
641 15# 3000 32.19 
6410(20) 20# 2400 31.75 


145.00 

99.00 


MODEM 

Lexicon IX-11 300 baud acoustic 
Signalman 300 baud 

ROBINS (Roberts Information Services. 
Inc.) (703) 560-5900 (800)336-0198 

8306 Hilltop Road Fairfax, VA 22031 
(across from the Post Office in Merrifieldl 
Monday-Friday 9 to 5 Saturday 10 to 2 
Vfe ship by Capital Messengers and UPS 
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PILOT Of TH€ 

by PquLq Benson 


The following is a recap of the presenta- 
tion at the October WAP meeting by Robert 
Platt. It is essentially a followup to the 
article he authored on PILOT in the May 
1982 issue of the Pi. 

Computer Assisted Instruction (CAI) is a 
very well known buzz word today in educa- 
tion, as computer technology continues to 
become more evident in the classroom. The 
computer is not meant to replace the 
teacher but to be a tool to allow the 
teacher to exercise greater creativity in 
aiding a student where individualized help 
is needed. CAI typically uses the com- 
puter to present information, to test the 
student and to provide additional informa- 
tion as needed or requested. CMI, or 
Computer Managed Instruction, uses the 
computer essentially as a sophisticated 
gradebook. This article will discuss CAI 
languages, focusing mainly on PILOT. 

Three kinds of audiences might be in- 
terested in CAI. Institutions such as 
schools and corporations use computers in 
imparting knowledge and training. For home 
users, the computer can provide a fun way 
to spend time in drill and practice that is 
necessary in certain subjects such as 
vocabulary or multiplication tables. Self- 
improvement opportunities are possible by 
means of flash card drills and repetitive 
presentations. Whatever the audience, 
designing a lesson invokes the creativity 
of the programmer. To get into the shoes 
of the user and to develop a usable presen- 
tation through their eyes is a challenging 
task. 

PILOT stands for Programmed Inquiry, Learn- 
ing Or Teaching. It was developed on a 
main frame computer in 1968. Later ver- 
sions were developed which ran on the 
Apple. The syntax is simple; each command 
consists of a one or two letter code, a 
colon, and the object of the command. A 
simple interpreter reads each line, deter- 
mines what the command is, calls the appro- 
priate routine, and performs the operation- 
al sequence. For example, 

T: Hello (Hello is printed) 

There are other languages usable for CAI. 
A little comparison can be of use in 
evaluating PILOT. PLATO is the most 
sophisticated CAI language. It was also 
built for the large main frame computer as 
a time sharing instructional system. Sur- 

E risingly, a version was developed for the 
502 which maintains the same level of 
sophistication. The quick response possi- 
ble on micros is useful for holding the 
student’s attention. PASCAL is another 
language available for CAI. It is harder 
to learn, but perhaps better for developing 
teaching systems than PILOT. It has a 
faster execution time. BASIC is also 
usable for CAI. For a more interrelated 
network of lessons, it perhaps would give 


better results than PILOT. The pertinent 
uestions you should ask yourself in choos- 
ng from among the three are ’’Which lan- 
guage do I know or am willing to learn, and 
which would achieve the set goals?” For 
most applications, PILOT does not produce 
that much better results than PASCAL or 
BASIC. 

VERSIONS of PILOT 

Apple Pilot is marketed by Apple Computer, 
Inc. It requires 48K of memory and 2 disk 
drives for lesson development. It lists 
for $150. SuperPilot is a newer version of 
Apple Pilot that lists for $200. (Ref. 1) 
It requires a 16K RAM card, displays color 
text on a colored background, has headline 
characters, and will control external 
devices such as a video disk. No upgrade 
offer is available to trade from an Apple 
Pilot kit to SuperPilot. (Ref. 2) Muse 
Software has their version of PILOT. WAP 
disk #110 contains an Applesoft version of 
a PILOT interpreter taken from the Feb '81 
Creative Computing. PIG disk #3 contains a 
PILOT to PASCAL translator taken from the 
July ’81 Byte. Nevada Pilot is also avail- 
able, but requires a Z80 card with CP/M. 

DEVELOPING A PILOT PROGRAM 

In developing a Pilot program the format 
for the lesson should be well defined. New 
material can be interspersed with ques- 
tions. The student then enters into a dia- 
logue with the computer in an exchange of 
information and evaluation. The format can 
be that of problem solving drills, perhaps 
using a game concept. The format can also 
be that of role playing or simulation. 

The lesson itself should be outlined for 
clarity and comprehensiveness. Information 
presentation should be well paced. The 
logical flow is important to maintain since 
PILOT allows for branching. To review 
material the student can go back to earlier 
segments. To acquire additional informa- 
tion the student can be directed to other 
segments. In order to maintain the atten- 
tion of the student, the lesson must be 
made attractive. A PILOT lesson can attain 
entertainment value by the use of colors, 
sound, graphics and even the arrangement of 
the text. The consistent use of the same 
keys for controlling the various functions 
aids in the learning process. 

In Apple Pilot there are two modes of 
operation: the author or the student. The 
author has four editors or utilities for 
developing the lesson. The lesson editor 
is a modified version of the Apple Pascal 
text editor. It is used as a text editor 
to enter lesson and interaction commands. 
There is a character set editor to insert 
special character sets such as headline 
types. The special effects editor allows 
entry of "musical” notes. For example a 
lesson can include a theme song, or 

contd. 
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raspberries to respond to a wrong answer. 
(Ed. Note: Positive responses to a wrong 
answer and corrective guidance are con- 
sidered to be better practice.) Each 
note's pitch is typed in using A thru G, 
and the timing of each note is set. The 
raphics editor is used to create pictures 
n Hi-res graphics. With 0,0 at the lower 
left corner of the screen, points are 
placed on a grid in X,Y fashion using 
cursor control keys. 

PILOT COMMANDS 

T - type command. The type command is 
similar to PRINT in BASIC. This command 
also gives control over tab, clearing 
screen and inverse. The T command checks 
for spaces between words, breaking up a 
line between words, if necessary, rather 
than within a word. 

A - accept answer. The response can be 
stored in a variable. A:$N$ stores the 
response in string variable N. This is 
similar to INPUT in BASIC. 

M - match command. The match command is 
the means by which the program tests 
whether a correct answer was given. The 
response must be spelled correctly. More 
sophisticated options in SuperPilot give 
more leeway in spelling. For instance, it 
will look for fragments of words while 
permitting a variety of endings (s, ing). 


development and text in another. Graphics 
is rather slow but SuperPilot's graphics is 
reported to be faster. Lesson execution is 
sluggish too because Apple Pilot uses only 
48k. It must read in separate routines from 
the disk for each command. To list the 
lesson, the standard Apple printer con- 
troller card must be used in slot #1. 

There are viable alternatives to Apple 
Pilot, e.g. Pascal. that give more 
flexibility and multiple disk files. 

POSITIVE ASPECTS 

Apple Pilot is a user friendly package. 
Only one drive is needed once development 
is complete. It requires only 48k. The 
lesson disks are turnkey operations. Help 
sequences can be programmed where the com- 
puter either gives the correct answer or 
umps to "help" pages with a review of the 
nstruction material. It is easy to use 
the music and graphics editors. The 
graphics routines use the Hi-res Turtle- 
graphics of the Apple Pascal system. The 
text editor has upper and lowercase capa- 
bility. Apple Pilot performs as advertised 
though SuperPilot does even better. Class 
statistics can be kept using SuperPilot. 
Using PILOT on the computer in a teaching 
environment is a viable alternative to 
standard methods. 

REFERENCES 


J - jump command. At this point if the 
correct answer is given, there is a presen- 
tation of new material. If the student 
doesn't know, the correct answer is pro- 
vided and the material is reviewed. This 
jumping to another section of the lesson is 
part of the branching logic of PILOT. It 
is not very sophisticated, however. There 
can be a number of jumps all going to the 
same routine. This permits some rudimentary 
tailoring of the lesson to the individual. 

G - graphics command. This command makes 
use of the Hi-res screen and plots points 
or lines. This command is similar to the 
BASIC commands HGR and HPLOT. 


(1) Creative Computing, January 1982. 

(2) Infoworld. Vol. 4. No. 45, pg. 45, 
November 1 5 , 1982) 
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S-C MACRO ASSEMBLER 

S-C Macro Assembler has the happiest users! 

“Makes assembly language programming on the Apple 
as easy as programming in BASIC." Chuck Carpenter. 
Carrollton. Texas 


A few other commands are available to 
generate remark statements, link to other 
programs, etc. 

In summary, the basic idea is to present 
text with the T command, get the answers 
back using the A command, check for cor- 
rectness of the response with the M com- 
mand, and jump to an appropriate lesson 
segment with the J command. 

NEGATIVE ASPECTS 

The Apple Pilot package is overpriced. 
There are similar capabilities on the WAP 
$5 library disks. Most PILOT programs are 
nonstandard and non transferable. One 
can't intermix Apple Pilot, the Pascal 
editor and the library disk interpreter 
versions of PILOT. It is hard to envision 
\ the graphics display as it is being 
entered. It has to be plotted and then 
viewed. The same graphics editor can not 
be used to place text on the screen under 
the graphics display. Rather, graphics 
must be developed in one stage of lesson 


“It s great! I can now cease my quest for that great 
assembler in the sky." Rip Kemp, Miami, Florida 

“ Great job. This new assembler is what I’ve been wait- 
ing for. It makes my work twice as efficient." Peter J. 
Okos, Chatsworth. California 

“Excellent Software. I've never used an assembler be- 
fore, but this one made me feel right at home.” Dale 
Sullivan, Glendale Heights, Illinois 

S-C Macro Assembler, the easiest to use yet most 
powerful and complete assembler for the Apple, is only 
$80. We accept Visa, MasterCard, and American Ex- 
press. 

S-C SOFTWARE CORPORATION 
2331 Gus Thomasson, Suite 125 
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8227 Woodmont Avenue 
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22nd Annual Technical Symposium of the Washington, DC, Chapter of the ACM 
June 23, 1983 National Bureau of Standards Gaithersburg, md 


CALL FOR PAPERS 


Institute for Computer 
Sciences and Technology 
National Bureau of Standards 
U.S. Departmentof Commerce 


Washington, DC, Chapter 
Association for 
Computer Machinery 


SPONSORED BY 


MICROCOMPUTER 


•I980BAUY 
MIDWAY 
MFC. CO. 


Papers are invited from government, industry and academia covering hardware and 
software systems. Non-commercial exhibits and demonstrations are also invited. 


Proceedings will be published. Papers will be refereed. 

TO SUBMIT YOUR PAPERS 

1 . By January 7, 1983 submit five double-spaced manuscripts of a paper not previously published to the Program Chairman 

Mr. Stewart A. Grossman 2 Fallswood Court Potomac, Maryland 20854. 

2. A length of 10 to 20 double-spaced pages is strongly suggested. Brief 400-word summaries on current research will also 
be considered. 

3. By February 18, 1983 authors will be notified. 

4. By April 15, 1983 return revised papers typed camera-ready on special forms which will be provided. 

5. June 23, 1983 present the paper. About 20 minutes are allowed for full-length papers; 10 minutes for current research 

summaries. . J&fsjj •' 
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WAP TUTORIAL REGISTRATION 


A WAP tutorial on Advanced Pascal will be taught by Dr. Tom Woteki (Dr. Wo). It will 
be held beginning the week of January 9 on four consecutive weekly dates at USUHS (on 
the campus of the Bethesda Naval Medical Center, 4301 Jones Bridge Road, Bethesda, MD. 
(Exact room, dates and times have not yet been determined. Contact Dr. Wo (547-0984 
for this information.) 

This tutorial is designed for individuals who have a good working knowledge of Pascal 
programming and who want to learn some advanced techniques such as using library units 
in program development, and writing device drivers. Some suggested topics were given 
in the November WAP Newsletter. 

The fee is $45 if you bring a 64K APPLE, disk drive and monitor; $60 if you do not. 
Please note that if you do not bring an APPLE, there will NOT be one available for you 
- you will have to "look over someone’s shoulder". (See the remarks on this subject 
under Tutorials in the President’s Corner elsewhere in this issue.) 

Please add $10 to the fee if you are not a WAP member. 


Name 

Daytime Phone Evening Phone 


WICUR. UUG • , 

I will bring an Apple, etc. (fee $45, WAP Membership No. ) Non-member + $10 

I will not bring an Apple (fee $60, WAP Membership No. ) Non-member + $10 

Please return application and check made out to "Washington Apple Pi, Ltd." to: 

Steve Stern 

6921 Old Stage Road 

Rockville, MD 20852 


WASHINGTON APPLE PI MAGAZINE MAIL ORDER FORM 


If you would like to order back issues of the Washington Apple Pi newsletter or 
"Inside Apple Pi" (a compendium of our 1979-1980 articles), please check the 
appropriate box(es) below. If you order 5 or more back issues we will pay the postage 
(U.S. only); for 1-4 issues add $.50 postage each. The price for "Inside Apple Pi" is 
$7.50, including postage for U.S. 


( ) $1.50 October 

I ) $1.50 April 
) 81.50 June 
) 81.50 Jul/Aug 
) i> 1 . 50 Sept. 

) 81.50 October 
) 81.50 Nov. 

) $1.50 Dec. 


1980 Volume 2, No. 

1981 Volume 3, No. 
1981 Volume 3, No. 
1981 Volume 3, No. 
1981 Volume 3, No. 
1981 Volume 3, No. 
1981 Volume 3, No. 
1981 Volume 3, No. 


10 

4 

6 

I 

9 

10 

II 


( ) $7.50 Inside Apple Pi 


( ) $2.00 January 1982 Volume 4 

1 82.00 Feb. 1982 Volume 4 
) 82.00 March 1982 Volume 4 

) 82.00 April 1982 Volume 4 

) 82.00 May 1982 Volume 4 

82.00 June 1982 Volume 4 

) 82.00 July 1982 Volume 4 

j 82.00 August 1982 Volume 4 

) 82.00 Sept. 1982 Volume 4 

) 82,00 October 1982 Volume 4 

( ) $2.00 Nov. 1982 Volume 4 


No. 1 
No. 2 
No. 3 
No. 4 
No. 5 
No. 6 
No. 7 
No. 6 
No. 9 
No. 10 
No. 11 


Total No. of issues at $1.50 

Total No. of issues at $2.00 

Inside Apple Pi at $7.50 
Postage, if any: 

U.S. 1-4 back issues add $.50 each 
Foreign add $1.50 for each back issue 
add $2.50 for Inside Apple Pi 


= 8 
= 8 
= 8 * 
= 8 ' 


TOTAL AMOUNT ENCLOSED $. 


NAME 

ADDRESS 

CITY, STATE, ZIP 

Make check payable to "Washington Apple Pi, Ltd." and send to: 
Washington Apple Pi, Ltd. 

Attn. Magazines 
P.0. Box 34511 
Bethesda, MD 20817 
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WASHINGTON APPLE PI DISK LIBRARY MAIL ORDER FORM 


PLEASE NOTE: This form is no longer to be used for disks to be picked up at a 
meeting. 

Washington Apple Pi's library disks are available for purchase. Use this form 
for disks that you want mailed to you. If you want to pick them up at a 
meeting, do not pre-order. Pay for them and pick them up "on the spot" between 
8:30 ana 10:00 AM at the meeting. 


PROGRAM DISKETTES: 

Mailed to you (1st 5): Members $ 7.00; Non-members $10.00. 
" (remainder) " $ 5 . 00 ; " $ 8.00 


DOS 3.2 
Volume 

1 

Volume 

2 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

2 

l 

9 

Volume 

10 

Volume 

11 

Volume 

12 

Volume 

13 

Volume 

14 

Volume 

15 

Volume 

16 

Volume 

17 

Volume 

18 

Volume 

19 

Volume 

20 

Volume 

21 

Volume 

22 

Volume 

23 

Volume 

24 

Volume 

25 

Volume 

26 

Volume 

27 

Volume 

28 

Volume 

29 

Volume 

30 

Volume 

31 

Volume 

32 

Volume 

Volume 

12 

Volume 

35 

Volume 

36 

Volume 

Volume 

Volume 

Volume 

ll 

V 

DOS 3.3 
Volume 

180 

Volume 

181 

♦Volume 

182 

♦Volume 

183 

184 

♦Volume 

♦Volume 

185 

♦Volume 

186 


Utilities I 
Utilities II 
Games I 
Games II 
Games III 
Games IV 
Games V 
Utilities III 
Educational I 
Math/Science 
Graphics I 
Games VI 
Games 

IAC Utilities IV 
Games VII 
Utilities V 
Graphics II 
Educational II 
Communications 
Music 

Apple Orchard 
Utilities VI 
Games VIII 
Games IX 
Utilities VII 
Stocks/Investments 
Math 

Planet finder 
Utilities VIII 
Games X 

Plot Utilities 
Games XI 
Accounting 
Solar Tutor 
Garden Managment 
Games XII 
Utilities IX 
Games XIII 
IAC VII 
IAC VIII 


Dungeon Designer ( ) 
Beginners Cave ( ) 
Lair of the Minotaur ( ) 
Cave of the Mind ( ) 
Zyphur Riverventure ( ) 
Castle of Doom ( ) 
Death Star ( ) 


* Volume 181 required with these disks. 
♦♦Both 1 1 4A and 114 b required. 


♦Volume 

♦Volume 

♦Volume 

♦Volume 

♦Volume 

♦Volume 

♦Volume 

♦Volume 

♦Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 

Volume 


187 Devil's Tomb 

188 Caves of Treas. Island 

189 Furioso 

190 The Magic Kingdom 

191 The Tomb of Molinar 

192 Lost Island of Apple 

193 The Abductor's Quarters 
19* The Quest for Trezore 
195 The Underground City 

100 Utilities A 

101 Utilities B 

102 Games A 

103 Merry Christmas 

104 Business A 

105 FIG-FORTH/Utilities 

106 Science Engineering 

107 Games B 

108 IAC 10 (Graphics) 

109 IAC 11 (Applesoft Tut.) 

110 Personal/Education 

111 Games C 

112 Utilities C 
Business B 

_ Adventure - INIT} ♦* 

1 1 4B Adventure } 

115 IAC 12/13 Miscellaneous 

116 IAC 14 Micromodem II 
Picture Packer 
Utilities D 

119 IAC 15 Miscellaneous 

120 IAC 16 Miscellaneous 

121 ABBS Program 

122 IAC 17 Miscellaneous 

123 French Vocabulary 

124 Utilities E 

125 IAC 18 Miscellaneous 


113 

114J 


( ) 


*»i 


11 

11 


300 Pascal PIG0 


301 

302 

303 

304 

305 

306 

307 

308 

309 


PIG1 

PIG2 

PIG 

PIG 

PIG5 

PIG 6 

PIG7 

PIG& 

PIG9 


ATTACH BIOS 


EDSIG1 (Elem. Math) 

Adv. Visicalc Tutorial Lessons 


n 


Total Order = 


disks. 


(NOTE: ALLOW 6 TO 8 WEEKS FOR MAILING.) 


NAME 

ADDRESS 

CITY, STATE ZIP 

TELEPHONE .WAP MEMBERSHIP NO. 

Make checks payable to "Washington Apple Pi". 

Send order to: Washington Apple Pi - ATTN: Librarian 

P.0. Box 34511 
Bethesda, MD 20817 
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Eve 
introduced 
the apple to 
Adam 


Now 
we’ve brought it 
to Bethesda 


Can we tempt you? 


As your authorized Apple dealer, Bethesda 
Computers specializes in the sale of micro- 
computers, software, peripheral equipment 
& accessories. Drop by for a "hands-on” 
demonstration and professional analysis of 
your computer needs. 



bethesda 

COMPUTERS 

o I n ! o I n I o 


Bethesda Computers 
8020 Norfolk Avenue 
Bethesda, Maryland 2001 4 
(301)657-1992 
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Now available from your computer store- 
the whole line of AJ couplers and modems. 



Starting now you can buy AJ acoustic data couplers and 
modems directly from your local computer store. 

Not just selected models. Any models. Ranging from the 
0-450 bps A 242A,-the world's most widely used acoustic data 
coupler, to the revolutionary AJ 1259 triple modem that 
handles 300 bps Bell 103, 1200 bps Bell 212A, and 1200 
bps VA 3400 protocols 

Whether you need full or half duplex or both in one; 
originate or answer, auto answer; acoustic coupling, or 
direct-connect— there's a model for you in the AJ line 

Starting now you don't have to settle for second best. 


For the location of your local 
computer store handling the AJ line, call 


AISDERSON JACOBSON GA I THERSBURC 
(301) 840-5700 

ANDERSON 
JACOBSON 



